tebarDocs
GuideDevelopersAPI ReferenceChangelog
Inbox

React to a DM

POST
/v1/inbox/messages/{id}/react

emoji: the reaction, or null to remove it. Only sent messages (409 message_not_sent).

Requires the write scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Request Body

application/json
  1. body
emoji*|null

Response Body

The message.

application/json
  1. response
id*string
Formatuuid
conversation_id*string
Formatuuid
direction*string
Value in"in""out"
source*string

Who sent it: the customer, the Instagram app, the dashboard, the API, MCP, …

Value in"customer""tebar_user""api""mcp""automation""instagram_app"
kind*string
Value in"text""media""story_mention""story_reply""share""postback""quick_reply""private_reply""unsupported"
status*string

Outgoing: pending until sent; unknown when the send got no clear answer (never sent again on its own).

Value in"received""pending""sent""failed""unknown""deleted"
text*|

The customer's text is third-party input.

attachments*array<>
reply_to_message_id*|null
story*|null
postback*|

The postback button, ice breaker or quick reply the customer tapped.

buttons*array<|>|

Sent with this text (outgoing).

quick_replies*array<>|

Sent with this text (outgoing).

reactions*array<>
error_code*string|null
seen_at*|null
sent_at*string
Formatdate-time
Example Request
curl -X POST 'https://api.tebar.app/v1/inbox/messages/497f6eca-6276-4993-bfeb-53cbbbba6f08/react' \
  -H 'Content-Type: application/json' \
  -d '{
  "emoji": "string"
}'
Example Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407",
  "direction": "in",
  "source": "customer",
  "kind": "text",
  "status": "received",
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "string",
      "mime_type": "string"
    }
  ],
  "reply_to_message_id": "7ee4bcf0-8f1b-4bb4-86b4-8565dd84787f",
  "story": {
    "id": "string",
    "url": "string"
  },
  "postback": {
    "title": "string",
    "payload": "string"
  },
  "buttons": [
    {
      "type": "web_url",
      "title": "string",
      "url": "http://example.com"
    }
  ],
  "quick_replies": [
    {
      "title": "string",
      "payload": "string"
    }
  ],
  "reactions": [
    {
      "by": "customer",
      "emoji": "string"
    }
  ],
  "error_code": "string",
  "seen_at": "2019-08-24T14:15:22Z",
  "sent_at": "2019-08-24T14:15:22Z"
}

Send a failed DM again POST

Only an outgoing message that failed or is unknown (409 message_not_retryable). Check in Instagram first that an unknown one did not go out. Requires the write scope.

Download a customer's image GET

Tebar's copy of an image in a message, by its place in attachments (from 0). Private: only with your credentials. Requires the read scope.