POST
/
v1
/
webhooks
Create a new webhook
curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v1/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "network_id": "base-sepolia",
  "event_type": "erc20_transfer",
  "event_type_filter": {
    "addresses": [
      "<string>"
    ],
    "wallet_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7"
  },
  "event_filters": [
    {
      "contract_address": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "from_address": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "to_address": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"
    }
  ],
  "notification_uri": "https://webhook.site/582307c2f9e1fac308a5f575",
  "signature_header": "your-custom-header"
}'
{
  "id": "582307c2f9e1fac308a5f575",
  "network_id": "base-sepolia",
  "event_type": "erc20_transfer",
  "event_type_filter": {
    "addresses": [
      "<string>"
    ],
    "wallet_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7"
  },
  "event_filters": [
    {
      "contract_address": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "from_address": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "to_address": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"
    }
  ],
  "notification_uri": "https://webhook.site/582307c2f9e1fac308a5f575",
  "created_at": "2024-07-21T17:32:28Z",
  "updated_at": "2024-07-21T17:32:28Z",
  "signature_header": "your-signature-header",
  "status": "active"
}

Authorizations

​
Authorization
string
header
required

Enter your JSON Web Token (JWT) here. Refer to the Generate JWT section of our Authentication docs for information on how to generate your Bearer Token.

Body

application/json

Response

200
application/json

The webhook

Webhook that is used for getting notifications when monitored events occur.