---
title: "Watch more addresses (bulk)"
method: POST
path: "/webhooks/{id}/addresses"
tags: ["Webhooks"]
---

# Watch more addresses (bulk)

`POST /webhooks/{id}/addresses`

## Request

- Base URL: `https://sochain.com/api/v3`
- URL: `https://sochain.com/api/v3/webhooks/{id}/addresses`
- Auth: API key in header `API-KEY`

## Path parameters

- `id` string, required

## Request body

- AddressList
  - `addresses` string[], required

## Response `200`

Success.

- object
  - `status` 'success', required
  - `data` WebhookAddressesAdded, required
    - `id` string, required
    - `added` integer, required: Addresses it didn't watch yet.
    - `num_addresses` integer, required: Addresses it watches now.

## Other responses

- `400`: A bad parameter or body; the message says which.
- `401`: An invalid key, no key where one is needed (buckets, webhooks, /account_info), a locked account or expired plan, or both the month's requests and the keyless rate used up. Kept as 401, with this message, for v3 compatibility.
- `403`: A read-only key, or a change past your plan's limits: data.error_message says which.
- `404`: Not found.
- `413`: A body over the limit: 256 KB where a call carries addresses or transaction IDs, 64 KB otherwise.
- `415`: A body that isn't JSON: send it with Content-Type: application/json.
- `503`: Briefly unavailable; retry with backoff. May carry Retry-After.

---

[API](https://skmtc.dev/sochain/apis/sochain-api.md) · [All operations](https://skmtc.dev/sochain/apis/sochain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sochain/apis/sochain-api/revisions/80682797b38f?raw)
