POST /api/v2/subscriptions/contact

Creates a contact event subscription for your company. A webhook_id is required so that we know to which url the events shall be sent.

See https://developers.dialpad.com/docs/contact-events for details on how contact events work, including the payload structure and payload examples.

Added on April 23rd, 2021 for API v2.

Requires a company admin API key.

Rate limit: 1200 per minute.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
contact_type String Yes

The contact type this event subscription subscribes to.

Possible values:

  • "local"
  • "shared"
endpoint_id Integer No

The logging endpoint's ID, which is generated after creating a webhook or websocket successfully.

enabled Boolean No

Whether or not the contact event subscription is enabled.

Default value: true

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.