Error
A valid request URL is required to generate request examples{
"data": [
{
"id": "<string>",
"inbox": {
"id": "<string>",
"phone_number": "+447700900123",
"name": "Sales line"
},
"contact": {
"id": "<string>",
"name": "<string>",
"phone_number": "<string>"
},
"last_message": {
"direction": "incoming",
"body": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"last_activity_at": "2023-11-07T05:31:56Z",
"archived": true
}
],
"next_cursor": "<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>"
}
}Conversations
List conversations
Business-wide, ordered by most recent activity. Conversations that
only hold calls (no message sent or received yet) are not listed.
Cursor-paginated: pass the
previous response’s next_cursor to fetch the next page; a null
next_cursor means the end. An unrecognised cursor returns
400 invalid_cursor.
GET
/
conversations
Error
A valid request URL is required to generate request examples{
"data": [
{
"id": "<string>",
"inbox": {
"id": "<string>",
"phone_number": "+447700900123",
"name": "Sales line"
},
"contact": {
"id": "<string>",
"name": "<string>",
"phone_number": "<string>"
},
"last_message": {
"direction": "incoming",
"body": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"last_activity_at": "2023-11-07T05:31:56Z",
"archived": true
}
],
"next_cursor": "<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:messages:read
Read messages.
Query Parameters
Required range:
1 <= x <= 100Opaque cursor from a previous response's next_cursor.
Only conversations on this inbox (see GET /inboxes).
Only conversations with this saved contact.
Was this page helpful?
.png)