Product

Use this API to send message with the Product template.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Request Parameters

KeyDescriptionValueData typeRequired/OptionalConstraints
AuthorizationAccess Token for the application{{PARTNER_APP_TOKEN}}StringRequiredShould be a valid Partner App Access Token
APP_IDApp ID to fetch the access token{{APP_ID}}StringRequired
  • The Id should be a valid app Id of Gupshup - The App must be associated with the account that owns the PARTNER_APP_TOKEN being used
sourceSource Phone Number{{SOURCE}}IntegerRequired
sandboxBoolean value{{SANDBOX}}BooleanOptional
destinationDestination Phone Number{{DESTINATION}}IntegerRequired
templateJson containing template details{ "id":"{{TEMPLATE_ID}}", "params":[ "{{PRODUCT_ID}}" ], "mpm":{ "sections":\[ { "title":"{{TITLE}}", "products":[ "{{PRODUCT_ID}}" ] }, { "title":"{{TITLE1}}", "products":[ "{{PRODUCT_ID}}" ] } ] } }StringRequired
  • Template must have valid template Id - Params must include all params including a product id - Sections param must be provided with valid ids{ "id": "\<template_id>", "params": [ <list_of_template_parameters> ]
src.nameApp Name{{APP_NAME}}StringRequired
channelChannel{{CHANNEL_NAME}}StringMust be Whatsapp
userIdBSUID{{userId}}

Sample Request

curl --request POST \
     --url https://partner.gupshup.io/partner/app/947d28b8-459b-4dfe-9d4c-0ac8c6c245c9/template/msg \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --header 'token: sk_711916ad1d5d4f21a9520fdef20516a1' \
     --data source=919643874844 \
     --data destination=918886912227 \
     --data sandbox=true \
     --data src.name=ProdMonitoringCloud \
     --data 'userId={{BSUID}}' \
     --data 'template={
   "id":"3b9bf65b-979c-44d3-a269-dec2f20c4e52",
   "params":[
      "zqc2qfz5fm"
   ],
   "mpm":{
      "sections":[
         {
            "title":"Products",
            "products":[
               "zqc2qfz5fm"
            ]
         },
         {
            "title":"Products2",
            "products":[
               "xyli96fcbn"
            ]
         }
      ]
   }
}' \
     --data channel=whatsapp

Sample Response

{
  "status": "submitted",
  "messageId": "eb152a75-6f6d-41c2-ba9b-ea8dae4d0f63"
}

Status Codes

Status CodeResponseComments
Success
200{ "status": "submitted", "messageId": "eb152a75-6f6d-41c2-ba9b-ea8dae4d0f63" }
Error
429{ "status": "error", "message": "Too Many Requests" }10 Requests per Minute
500{ "status": "error", "message": "Internal server error. Please try again later. If the issue still persists, then contact Gupshup Dev Support" }For any Internal Error

Path Params
string
required

Unique identifier of the app.

Form Data
integer
required

Source Phone Number

integer
required

Destination Phone Number

boolean

Boolean value

string
required

App Name

string
required

Json containing template details

string
required

Channel Name

Headers
string
required

Your app token, please refer Get access token api to get the token from partner documentation.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json