Skip to main content
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

Body

application/json
​
network_id
string
required
Example:
​
event_type
enum<string>
required
Available options:
unspecified,
erc20_transfer,
erc721_transfer,
wallet_activity,
smart_contract_event_activity
Example:
​
notification_uri
string
required
Example:
​
event_type_filter
object
  • Option 1
  • Option 2
​
event_filters
object[]
​
signature_header
string
Example:

Response

​
status
enum<string>
required
Available options:
active,
inactive
Example:
​
id
string
Example:
​
network_id
string
Example:
​
event_type
enum<string>
Available options:
unspecified,
erc20_transfer,
erc721_transfer,
wallet_activity,
smart_contract_event_activity
Example:
​
event_type_filter
object
  • Option 1
  • Option 2
​
event_filters
object[]
​
notification_uri
string
Example:
​
created_at
string<date-time>
Example:
​
updated_at
string<date-time>
Example:
​
signature_header
string
Example: