Use case

Reply to DMs

Works on: Instagram, Facebook, X

Work the inbox: list conversations, read the thread, reply, and archive what’s done.

  1. 1

    List active conversations.

    GET/v1/inbox/conversationsList conversations reference →
    curl "https://creatoros-production-5658.up.railway.app/v1/inbox/conversations?status=active&limit=20" \
      -H "Authorization: Bearer $CREATOROS_API_KEY"
  2. 2

    Read a thread.

    GET/v1/inbox/conversations/{conversationId}/messagesList messages reference →
    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"
  3. 3

    Reply. Attach a file with a med_ id if you need to.

    POST/v1/inbox/conversations/{conversationId}/messagesSend a message reference →
    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?"
      }'
  4. 4

    Archive it when it’s resolved.

    PUT/v1/inbox/conversations/{conversationId}Archive a conversation reference →
    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"
      }'

With the CLI

$ creatoros inbox:conversations --prettyCopy
$ creatoros inbox:messages <conv_id> --accountId <acc_id>Copy
$ creatoros inbox:send <conv_id> --accountId <acc_id> --message "..."Copy
$ creatoros inbox:update-conversation <conv_id> --accountId <acc_id> --status archivedCopy

Or ask your agent

“Anyone who DMed the word GUIDE this week and never got the link: send it with a one-line follow-up.”