Skip to main content
POST
Add a reaction
  • Credential: an API key. A trial key returns 401 unauthorized. See Reactions.
  • Line-scoped keys: a line-scoped key gets 404 not_found for a message on a line outside its list.
  • Test keys: a reaction sent with an isnap_test_ account key reaches the real contact: see Test keys.
  • Idempotency-Key: honored. The key shares the space of the line with POST /v1/messages. See Retrying a reaction.
  • Events: sends reaction.added when the line’s device confirms the reaction. Sends nothing when the device fails to place it.
  • Response: 202 means requested, not placed. reactions shows the reaction as soon as the API accepts it, and keeps showing it when the line’s device fails to place it. Wait for reaction.added.
  • The line’s device: the reaction needs a device that supports reactions. See What reaches the contact.
  • Sending limits: a reaction counts against none, and is never held.

Errors

The errors that every operation shares are in Errors.

Authorizations

Authorization
string
header
required

An API key created in the iSnap dashboard, or a trial key, sent as Authorization: Bearer <key>. An API key starts with isnap_live_ or isnap_test_; both act on the same account, lines and billing. A trial key acts on its trial only.

Path Parameters

id
string
required

Message id: msg_ followed by 25 letters or digits.

Pattern: ^msg_[0-9A-Za-z]{25}$

Body

application/json

The reaction to add.

type
enum<string>
required

The reaction to put on the message. It replaces the line's reaction on that message when there is one.

Available options:
love,
like,
dislike,
laugh,
emphasize,
question

Response

The reaction, accepted and handed to the line's device.

success
enum<boolean>
required

Always true on a success response.

Available options:
true
data
object
required

The line's reaction on a message, as accepted by POST /v1/messages/{id}/reactions.

trace_id
string
required

Trace id of the request that produced this response: 32 lowercase hexadecimal characters. Quote it when you report a problem to iSnap.

request_id
string
required

Id of the request that produced this response: req_ followed by 25 letters or digits.