---
title: "Update the webhook URL for receiving message events"
method: PUT
path: "/v1/api/config/webhook"
tags: ["Configuration"]
---

# Update the webhook URL for receiving message events

`PUT /v1/api/config/webhook`

Configure the webhook URL that will receive all message events. Once configured, your endpoint will receive POST requests with the following event types:

- `message.received` - When you receive an inbound message
- `message.sent` - When your outbound message is sent to the carrier
- `message.delivered` - When your outbound message is delivered to the recipient
- `message.failed` - When your outbound message fails to deliver
- `message.read` - When your outbound message is read by the recipient (iMessage only, recipient must have read receipts enabled)

See the webhook event schemas for detailed payload formats.

## Request body

- WebhookUpdateRequest
  - `webhook_url` string, uri, required

## Response `200`

Webhook URL updated.

- WebhookUpdateResponse
  - `status` string
  - `message` string

## Other responses

- `400` — Invalid request parameters.
- `401` — Invalid or missing API key.

---

[API](https://skmtc.dev/blooio/apis/blooio-messaging-api-v3.md) · [All operations](https://skmtc.dev/blooio/apis/blooio-messaging-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blooio/blooio-messaging-api-v3/revisions/2d1e4d94ef5b/schema)