.png)
Error
A valid request URL is required to generate request examples{
"imported": 123,
"duplicates": 123,
"skipped": 123,
"import_id": "<string>"
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}Campaigns
Add contacts to a campaign
Adds 1-500 contacts. Numbers are parsed like a CSV import (E.164, or
national format in the workspace’s country). A contact whose first
usable number is already in the campaign counts as a duplicate; one
with no usable number is skipped. All contacts added through the API
land in one “API” import in the campaign’s import history. Returns
400 once the campaign holds its maximum number of contacts.
POST
/
campaigns
/
{id}
/
contacts
Error
A valid request URL is required to generate request examples{
"imported": 123,
"duplicates": 123,
"skipped": 123,
"import_id": "<string>"
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"request_id": "<string>",
"field": "<string>"
}
}Authorizations
Authorization Code flow against Dialbird's OIDC provider. The issued
access token is a JWT with aud: "public-api", verified against the
issuer JWKS.
FlowAuthorization Code
- Authorization URL
- https://app-staging.dialbird.io/oidc/auth
- Token URL
- https://app-staging.dialbird.io/oidc/token
- Refresh URL
- https://app-staging.dialbird.io/oidc/token
Scopes1
api:campaigns:write
Create campaigns and add, update, and remove their contacts.
Headers
Client-generated key (≤255 chars) to make a write request safely retriable.
Maximum string length:
255Path Parameters
The campaign id.
Body
application/json
Required array length:
1 - 500 elementsShow child attributes
Show child attributes
Was this page helpful?