API resource
Direct messages
List conversations
/v1/inbox/conversationsWorks on: Instagram, Facebook, X, WhatsApp
DM threads across every account, most recently active first. Paginate with cursor.
Query parameters
platformstringOnly this network.
accountIdstringOnly this account.
statusstringactive or archived.
limitintegerPage size.
cursorstringpagination.nextCursor from the previous page.
curl "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations?status=active&limit=20" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"data": [
{
"id": "conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt",
"platform": "instagram",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"accountUsername": "kevbuildsapps",
"participantName": "Maya",
"lastMessage": "Is the course still open?",
"updatedTime": "2026-09-25T17:02:10.000Z",
"status": "active",
"unreadCount": 1
}
],
"pagination": {
"hasMore": false,
"nextCursor": null
}
}List messages
/v1/inbox/conversations/{conversationId}/messagesWorks on: Instagram, Facebook, X, WhatsApp
Messages in one thread, oldest first by default.
Path parameters
conversationIdstringrequiredThe conv_ id.
Query parameters
accountIdstringrequiredThe account (acc_...) the post or conversation belongs to.
limitintegerUp to 100.
cursorstringpagination.nextCursor from the previous page.
sortOrderstringasc (default) or desc.
curl "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations/conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt/messages?accountId=acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"status": "success",
"pagination": {
"hasMore": false,
"nextCursor": null
},
"messages": [
{
"id": "msg_Hk2Qp7Vz4Ny9Tx1Lm6Rc3Wb8Js5Df0Ga7Ue2Ki4Oq9X",
"conversationId": "conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "instagram",
"message": "Is the course still open?",
"senderName": "Maya",
"direction": "incoming",
"createdAt": "2026-09-25T17:02:10.000Z",
"attachments": []
}
]
}Start a conversation
/v1/inbox/conversationsWorks on: WhatsApp, X
Messages someone first. If a conversation with them already exists, the message joins that thread.
WhatsApp only delivers free text within 24 hours of the customer’s last message, so a new conversation starts with an approved template: pass templateName, templateLanguage and templateParams (values for the template’s variables, in order). Meta bills the delivery to your WhatsApp Business account. On X, pass message.
Body
accountIdstringrequiredThe account (acc_...) the post or conversation belongs to.
participantIdstringWhatsApp: the phone number in international format (+14165550123). X: the numeric user id.
participantUsernamestringX handle, instead of participantId.
messagestringMessage text (X).
templateNamestringWhatsApp: an approved template (see WhatsApp templates and flows).
templateLanguagestringWhatsApp: the template’s language code, e.g. en_US.
templateParamsstring[]WhatsApp: values for the text header, body and dynamic URL buttons, in that order.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"participantId": "+14165550123",
"templateName": "order_update",
"templateLanguage": "en_US",
"templateParams": [
"Sam",
"#1042"
]
}'{
"success": true,
"data": {
"messageId": "msg_Hk2Qp7Vz4Ny9Tx1Lm6Rc3Wb8Js5Df0Ga7Ue2Ki4Oq9X",
"conversationId": "conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt",
"participantId": "14165550123"
}
}Search conversations
/v1/inbox/conversations/searchWorks on: WhatsApp, Instagram, Facebook, X
Finds conversations by words inside messages, or by the contact’s name, username or phone number. Each hit carries up to 3 of its most recent matching messages.
Query parameters
querystringrequiredText to search for.
directionstringincoming or outgoing: only match messages sent to you or by you.
platformstringLimit to one network, e.g. whatsapp.
accountIdstringThe account (acc_...) the post or conversation belongs to.
limitintegerMaximum conversations to return.
cursorstringpagination.nextCursor from the previous page.
curl "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations/search?query=refund" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"data": [
{
"conversation": {
"id": "conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt",
"platform": "whatsapp",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"participantName": "Sam Lee",
"lastMessageAt": "2026-10-09T17:20:00.000Z"
},
"matchCount": 1,
"matches": []
}
],
"pagination": {
"hasMore": false,
"nextCursor": null
}
}Send a message
/v1/inbox/conversations/{conversationId}/messagesWorks on: Instagram, Facebook, X, WhatsApp
Replies in the thread. Attach one file with attachmentUrl, which can be a med_ id from Upload media.
Path parameters
conversationIdstringrequiredThe conv_ id.
Body
accountIdstringrequiredThe account (acc_...) the post or conversation belongs to.
messagestringMessage text. Required unless attaching.
attachmentUrlstringA med_ id or public URL.
attachmentTypestringimage, video, audio or file.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations/conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt/messages" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"message": "It is! Enrollment closes Friday. Want the link?"
}'{
"success": true,
"data": {
"messageId": "msg_Hk2Qp7Vz4Ny9Tx1Lm6Rc3Wb8Js5Df0Ga7Ue2Ki4Oq9X",
"conversationId": "conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt"
}
}Mark as read
/v1/inbox/conversations/{conversationId}/readWorks on: Instagram, Facebook, X, WhatsApp
Clears the unread count for a conversation.
Path parameters
conversationIdstringrequiredThe conv_ id.
Body
accountIdstringrequiredThe account (acc_...) the post or conversation belongs to.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations/conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt/read" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r"
}'{
"success": true
}Archive a conversation
/v1/inbox/conversations/{conversationId}Works on: Instagram, Facebook, X, WhatsApp
Set status to archived to file a thread away, or active to bring it back.
Path parameters
conversationIdstringrequiredThe conv_ id.
Body
accountIdstringrequiredThe account (acc_...) the post or conversation belongs to.
statusstringrequiredactive or archived.
curl -X PUT "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations/conv_9WFW-MsJBK43x7I-Ij21W7ZmevMKhsEYFQ2Bv8Kx5Rt" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"status": "archived"
}'{
"success": true
}