Text

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":"text",
  "text": "https://www.google.com","previewUrl":true}' \
--data-urlencode 'src.name={{APP_NAME}}'

Sample Request

Without Context

curl --location 'https://api.gupshup.io/wa/api/v1/msg' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'apikey: xvnwgh9vgbbl6gjeezymu5v5iepxq2zt' \
--data-urlencode 'channel=whatsapp' \
--data-urlencode 'source=918XXXXX541' \
--data-urlencode 'destination=917XXXXX6501' \
--data-urlencode 'message={
  "type": "text",
  "text": "https://www.google.com",
  "previewUrl": true
}' \
--data-urlencode 'src.name=TedLasso'

With Context

curl --location 'https://api.gupshup.io/wa/api/v1/msg' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'apikey: xvnwgh9vgbbl6gjeezymu5v5iepxq2zt' \
--data-urlencode 'channel=whatsapp' \
--data-urlencode 'source=918XXXX4541' \
--data-urlencode 'destination=917XXXX6501' \
--data-urlencode 'message={
  "context": {
    "msgId": "ss"
  },
  "type": "text",
  "text": "https://www.google.com",
  "previewUrl": true
}' \
--data-urlencode 'src.name=TedLasso'

Request Parameters

Parameter Name	Location	Type	Description	Required	Example
apikey	Header	string	APIKEY of your Gupshup Account	Yes	61b3021c97214370b341f8baaae0xxxx
source	Form	integer	Source Phone Number	Yes	918929874278
destination	Form	integer	Destination Phone Number	Yes	918805162043
src.name	Form	string	App Name	Yes	august18
message	Form	object	Message object (refer to schema)	Yes	Refer to Message schema below

Message Object (Form Parameter)

Property Name	Type	Description	Required	Example
context	object	Message context	No	{ "msgId": "uniqueMsgId" }
text	string	Message text	Yes	Welcome to Gupshup
type	string	Type of session message	No	text
previewUrl	boolean	Enable preview if the text contains URL	No	false

Response Parameters

Parameter Name	Type	Description	Example
status	string	Response status	submitted, error
messageId	string	Unique message ID	183dc8f1-7ecc-4419-895f-04fd0b1bfe07
message	string	Error message	Invalid Destination, Authentication Failed, Too Many Requests
status	string	Status of the request	error

Status Codes

Status Code	Description	Response Schema
200	Successful response	{ "status": "submitted", "messageId": "uuid" }
400	Bad Request	{ "message": "Invalid Destination", "status": "error" } or { "message": "Invalid App Details", "status": "error" }
401	Authentication Failed	{ "message": "Authentication Failed", "status": "error" }
429	Too Many Requests	{ "message": "Too Many Requests", "status": "error" }