Reaction

cURL

curl --location 'https://api.gupshup.io/wa/api/v1/msg' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'apikey: {{APIKEY}}' \
--data-urlencode 'source={{SOURCE}}' \
--data-urlencode 'destination={{DESTINATION}}' \
--data-urlencode 'message={
  "type": "reaction",
  "msgId": "bb8bad1b-d92e-4b02-8fbd-fbeef979569c",
  "emoji": "😃"
}' \
--data-urlencode 'src.name={{APP_NAME}}'

Sample Request

curl --location 'https://{BaseURL}/wa/api/v1/msg' \
--header 'Cache-Control: no-cache' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'apikey: xvnwgh9vgbbl6gjeezymu5v5iepxq2zt' \
--header 'cache-control: no-cache' \
--data-urlencode 'channel=whatsapp' \
--data-urlencode 'source=918097424541' \
--data-urlencode 'destination=91735824xxxx' \
--data-urlencode 'message={
  "type": "reaction",
  "msgId": "bb8bad1b-d92e-4b02-8fbd-fbeef979569c",
  "emoji": "😃"
}' \
--data-urlencode 'src.name=TedLasso'

Request Parameters

Header Parameters

Parameter NameLocationTypeDescriptionRequiredExample
apikeyHeaderstringAPIKEY of your Gupshup AccountYes61b3021c97214370b341f8baaae0xxxx

Form Parameters

Parameter NameLocationTypeDescriptionRequiredExample
sourceFormintegerSource Phone NumberYes918929874278
destinationFormintegerDestination Phone NumberYes918805162043
src.nameFormstringApp NameYesaugust18
messageFormobjectMessage object (refer to schema)YesRefer to Message schema below

Message Object (Form Parameter)

Property NameTypeDescriptionRequiredExample
typestringType of session messageYesreaction
emojistringEmojiNo😀
msgIdstringMessage ID for which reaction is sentYesef740cec-3352-4a81-a732-34a4b70aa709

Response Parameters

Parameter NameTypeDescriptionExample
statusstringResponse statussubmitted
messageIdstringUnique message ID183dc8f1-7ecc-4419-895f-04fd0b1bfe07
messagestringError messageInvalid Destination, Invalid App Details, Authentication Failed, Too Many Requests
statusstringStatus of the requesterror

Status Codes

Status CodeDescriptionResponse Schema
200Successful response{ "status": "submitted", "messageId": "183dc8f1-7ecc-4419-895f-04fd0b1bfe07" }
400Bad Request{ "message": "Invalid Destination", "status": "error" }
or
{ "message": "Invalid App Details", "status": "error" }
401Authentication Failed{ "message": "Authentication Failed", "status": "error" }
429Too Many Requests{ "message": "Too Many Requests", "status": "error" }
Language
Click Try It! to start a request and see the response here!