Notify API

All the possible HTTP requests you can make when using the Notify API.

We recommend using this Notify API when dealing with Address Activity Webhooks for 10+ addresses.

NOTE: Your Alchemy authentication token can be found in the upper right corner of your dashboard Notify page under the "AUTH TOKEN" button.

get
Get all webhooks

https://dashboard.alchemyapi.io/api/team-webhooks
This endpoint allows you to get all webhooks from every app on your team.
Request
Response
Request
Headers
X-Alchemy-Token
required
string
Alchemy Auth token to use the Notify API (see hint above).
Response
200: OK
Sample Response:
{
"data": [
{
"id": 3,
"app_id": "nd7cdkfe3cb4",
"network": 0,
"webhook_type": 1,
"webhook_url": "http://www.YOUR-APP-URL.com",
"is_active": true,
"time_created": 1585779080000,
"addresses": null
},
{
"id": 17,
"app_id": "pd63r8git3dlll0n",
"network": 0,
"webhook_type": 4,
"webhook_url": "http://www.YOUR-APP-URL.com",
"is_active": true,
"time_created": 1596635655000,
"addresses": [
"0xfdb16996831753d5331ff813c29a93c76834a0ad",
"0x6b175474e89094c44da98b954eedeac495271d0f",
"0x48ea66f94518534ecbc863fbf521896d52b025d9",
"0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x6f8d0c2a2c3a189803f5c6482c88be46a55058c1"
]
}
]
}

post
Create webhook

https://dashboard.alchemyapi.io/api/create-webhook
This endpoint allows you to create a webhook. Each type of webhook is represented as a different integer under webhook_type: Mined Transactions: 0, Dropped Transactions: 1, Address Activity: 4
Request
Response
Request
Headers
X-Alchemy-Token
required
string
Alchemy Auth token to use the Notify API
Body Parameters
app_id
required
string
App Id
webhook_type
required
integer
An Integer representing webhook type. Mined Transactions: 0 Dropped Transactions:1 Address Activity: 4
webhook_url
required
string
URL where requests should be sent
addresses
optional
array
List of addresses you want to track. For address activity webhooks only.
Response
200: OK
Sample response.
{
"data": {
"id": 23,
"app_id": "or56wq45csytgg",
"network": 0,
"webhook_type": 2,
"webhook_url": "http://www.YOUR-APP-URL.com",
"is_active": true,
"time_created": 1598971836000,
"addresses": null
}
}

put
Update webhook addresses

https://dashboard.alchemyapi.io/api/update-webhook-addresses
Used to update webhook addresses, replacing any existing addresses.
Request
Response
Request
Headers
X-Alchemy-Token
required
string
Alchemy Auth token to use the Notify API
Body Parameters
webhook_id
required
string
Identifier for the webhook
addresses
required
array
New list of addresses to track. This replaces any existing addresses.
Response
200: OK
{}

put
Update webhook active status

https://dashboard.alchemyapi.io/api/update-webhook-is-active
Allows you to set active status of webhooks to active or inactive.
Request
Response
Request
Headers
X-Alchemy-Token
required
string
Alchemy Auth token to use the Notify API
Body Parameters
webhook_id
required
string
Identifier for the webhook
is_active
required
boolean
True - set webhook to active state False - set webhook to inactive state
Response
200: OK
{}

delete
Delete webhook

https://dashboard.alchemyapi.io/api/delete-webhook
Delete a webhook.
Request
Response
Request
Headers
X-Alchemy-Token
required
string
Auth token for Notify API
Body Parameters
webhook_id
required
string
Unique webhook identifier
Response
200: OK
{}