POST /api/v2/dispositions
Creates a disposition for an office.
Rate limit: 1200 per minute.
Servers
- https://dialpad.com/
- https://sandbox.dialpad.com/
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 |
|---|---|---|---|
dispositions |
Null | No |
A dict mapping disposition names to their config. Each value has three optional tilde-prefixed control attributes: ~usage: "everything" (default) | "inbound" | "outbound" — call direction restriction. ~followup: bool — whether this disposition requires a follow-up action. ~default: bool — whether this is the default selection. Any other key in the value dict is a sub-disposition name with the same structure. Example: { "resolved": {"~usage": "everything"}, "callback": {"~usage": "inbound", "~followup": true}, "escalate": { "~usage": "outbound", "tier2": {"~usage": "outbound"}, "manager": {}, }, } |
name |
String | Yes |
[single-line only] The name of the parent disposition. |
office_id |
Integer | Yes |
The ID of the office assigned to the dispositions. |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.