SharedKeys

Create a new SharedKey

Creates a new Shared Key for webhook signature validation.

IMPORTANT: The secret field is ONLY returned in this response and cannot be retrieved later. Store it securely in your secrets management system.

post/v1/Webhooks/SharedKeys

Request

  • Base URL
    https://webhooks.twilio.com
  • Auth
    HTTP basic

Headers

Idempotency-Keystring uuid

Idempotency key for mutation operations. Must be a UUIDv7 (other UUID versions are rejected with a 400).

Request body

friendlyNamestring nullable

Human-readable name for the signing key (optional, defaults to blank)

Response

SharedKey created (secret included only in this response)

idstring required

Unique SharedKey identifier (TypeID/TTID format)

friendlyNamestring required

Human-readable name for identification

createdAtstring date-time required
updatedAtstring date-time required
secretstring required

Signing secret (only returned on POST, cannot be retrieved later)

Changes

No recorded changes to this operation across all 1 revision of this API.