{ "info": { "name": "GetReply API", "description": "GetReply API v1. Set the apiKey variable to your key. Requests sent here are real and charged like any other.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.getreply.in" }, { "key": "apiKey", "value": "gr_live_…" } ], "item": [ { "name": "Account", "item": [ { "name": "Your account", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/account", "host": [ "{{baseUrl}}" ], "path": [ "v1", "account" ] }, "description": "The business name, the plan and when it ends (India date), and the wallet.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Your WhatsApp number", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/number", "host": [ "{{baseUrl}}" ], "path": [ "v1", "number" ] }, "description": "Your WhatsApp number: display name, quality, daily messaging limit and whether it can send now.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Check your key", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/ping", "host": [ "{{baseUrl}}" ], "path": [ "v1", "ping" ] }, "description": "Answers when the key works. Use it to test your setup.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Message prices", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/prices", "host": [ "{{baseUrl}}" ], "path": [ "v1", "prices" ], "query": [ { "key": "country", "value": "", "disabled": true }, { "key": "category", "value": "", "disabled": true } ] }, "description": "The price of one message in rupees, by country and category — the same prices as in the app. Filter by country, category or both.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Your business profile", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/profile", "host": [ "{{baseUrl}}" ], "path": [ "v1", "profile" ] }, "description": "Your WhatsApp business profile: about, address, description, email, websites and category.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Edit your business profile", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/profile", "host": [ "{{baseUrl}}" ], "path": [ "v1", "profile" ] }, "body": { "mode": "raw", "raw": "{\n \"about\": \"Open 9 am to 9 pm, every day.\",\n \"websites\": [\n \"https://example.com\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Changes only the fields you give; the rest stay. The app's rules: about at most 139 characters, address 256, description 512, email 128; one website (https or http); category one of WhatsApp's categories (e.g. retail).\n\nPermission: A Full key." } }, { "name": "Today's usage", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/usage", "host": [ "{{baseUrl}}" ], "path": [ "v1", "usage" ] }, "description": "People messaged in the last 24 hours, your daily limit and what is left. The limit counts people, not messages.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Wallet transactions", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallet/transactions", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallet", "transactions" ], "query": [ { "key": "per_page", "value": "", "disabled": true }, { "key": "cursor", "value": "", "disabled": true } ] }, "description": "Your wallet's lines, newest first: type, amount, the balance after it, the message or campaign it belongs to, and when (India time). Read only. The newest line's balance after is your wallet's balance.\n\nPermission: Any key (Full, Send only or Read only)." } } ] }, { "name": "Contacts", "item": [ { "name": "List saved audiences", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/audiences", "host": [ "{{baseUrl}}" ], "path": [ "v1", "audiences" ] }, "description": "Your saved audience names (for campaigns).\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Save an audience", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/audiences", "host": [ "{{baseUrl}}" ], "path": [ "v1", "audiences" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Diwali buyers\",\n \"customers\": [\n \"+9198250*****\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Saves an audience the way the app does: a name and one tag, read again whenever a campaign uses it. Or give a list of customers (numbers or WhatsApp username ids, at most 1,000): they get a tag with the audience's name, and the audience follows that tag. Customers who are not contacts yet are left out and listed in not_found.\n\nPermission: A Full key." } }, { "name": "Blocked customers", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/blocked", "host": [ "{{baseUrl}}" ], "path": [ "v1", "blocked" ], "query": [ { "key": "per_page", "value": "", "disabled": true }, { "key": "cursor", "value": "", "disabled": true } ] }, "description": "The customers you blocked, as WhatsApp lists them. Not switched on for every account yet: not_available until it is.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "List contacts", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts" ], "query": [ { "key": "tag", "value": "", "disabled": true }, { "key": "page", "value": "", "disabled": true }, { "key": "per_page", "value": "", "disabled": true } ] }, "description": "Your contacts, newest first.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Add or update a contact", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts" ] }, "body": { "mode": "raw", "raw": "{\n \"phone\": \"+9198250*****\",\n \"name\": \"Riya\",\n \"tags\": [\n \"VIP\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "One contact per number: made the first time, updated after.\n\nPermission: A Full or Send only key." } }, { "name": "Delete a contact", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "Deletes a contact.\n\nPermission: A Full or Send only key." } }, { "name": "A contact", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "One contact by number or WhatsApp username id.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Edit a contact", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "Changes the name or your own fields.\n\nPermission: A Full or Send only key." } }, { "name": "Block a customer", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/block", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "block" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "Blocks a customer on WhatsApp. WhatsApp only allows it for people who wrote to you in the last 24 hours. Not switched on for every account yet: not_available until it is.\n\nPermission: A Full key." } }, { "name": "A customer's messages", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/messages", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "messages" ], "query": [ { "key": "per_page", "value": "", "disabled": true }, { "key": "cursor", "value": "", "disabled": true } ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "One chat, both directions, newest first: your messages (campaigns, replies, templates) and theirs. Never a test.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Resume marketing messages", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/resume-marketing", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "resume-marketing" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "Undoes stop-marketing, when the person asked for offers again.\n\nPermission: A Full or Send only key." } }, { "name": "Stop marketing messages", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/stop-marketing", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "stop-marketing" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "Marks that this person does not want marketing messages. Marketing templates and campaigns then leave them out.\n\nPermission: A Full or Send only key." } }, { "name": "Add or remove tags", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/tags", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "tags" ], "variable": [ { "key": "phone", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"add\": [\n \"VIP\"\n ],\n \"remove\": [\n \"New\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Adds and removes tags on one contact.\n\nPermission: A Full or Send only key." } }, { "name": "Unblock a customer", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/unblock", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "unblock" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "Unblocks a customer on WhatsApp. Not switched on for every account yet: not_available until it is.\n\nPermission: A Full key." } }, { "name": "Add or update many contacts", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", "bulk" ] }, "body": { "mode": "raw", "raw": "{\n \"contacts\": [\n {\n \"phone\": \"+9198250*****\",\n \"name\": \"Riya\",\n \"tags\": [\n \"VIP\"\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Up to 1,000 contacts in one call, each exactly like Add or update a contact. One row's error never stops the others: every row has its own result.\n\nPermission: A Full or Send only key." } }, { "name": "List tags", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/tags", "host": [ "{{baseUrl}}" ], "path": [ "v1", "tags" ] }, "description": "Your tag names.\n\nPermission: Any key (Full, Send only or Read only)." } } ] }, { "name": "Campaigns", "item": [ { "name": "List campaigns", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/campaigns", "host": [ "{{baseUrl}}" ], "path": [ "v1", "campaigns" ], "query": [ { "key": "status", "value": "", "disabled": true }, { "key": "page", "value": "", "disabled": true }, { "key": "per_page", "value": "", "disabled": true } ] }, "description": "Your campaigns, newest first.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Create a campaign", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/campaigns", "host": [ "{{baseUrl}}" ], "path": [ "v1", "campaigns" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Diwali offer\",\n \"template\": {\n \"name\": \"diwali_offer\",\n \"language\": \"en\"\n },\n \"audience\": {\n \"tag\": \"VIP\"\n },\n \"values\": {\n \"body\": [\n {\n \"from\": \"contact.name\",\n \"default\": \"there\"\n },\n \"20%\"\n ],\n \"buttons\": [\n {\n \"type\": \"copy_code\",\n \"value\": \"DIWALI20\"\n }\n ]\n },\n \"header_media\": {\n \"type\": \"image\",\n \"url\": \"https://example.com/offer.jpg\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends one approved template to many people now, or at a time you choose. The people: a list of numbers, a tag, or a saved audience. Every check runs first; a refused campaign makes nothing.\n\nPermission: A Full or Send only key." } }, { "name": "A campaign", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/campaigns/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "campaigns", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "One campaign with its counts and what it spent.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "A campaign's messages", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/campaigns/:id/messages", "host": [ "{{baseUrl}}" ], "path": [ "v1", "campaigns", ":id", "messages" ], "query": [ { "key": "status", "value": "", "disabled": true }, { "key": "page", "value": "", "disabled": true }, { "key": "per_page", "value": "", "disabled": true }, { "key": "cursor", "value": "", "disabled": true } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Per person: number, status, why it did not reach them, price. Up to 1,000 a page. Read them all in order with cursor (each answer's next_cursor); page still works.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Pause a campaign", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/campaigns/:id/pause", "host": [ "{{baseUrl}}" ], "path": [ "v1", "campaigns", ":id", "pause" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Pauses a sending campaign.\n\nPermission: A Full or Send only key." } }, { "name": "Resume a campaign", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/campaigns/:id/resume", "host": [ "{{baseUrl}}" ], "path": [ "v1", "campaigns", ":id", "resume" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Resumes a paused campaign.\n\nPermission: A Full or Send only key." } }, { "name": "Stop a campaign", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/campaigns/:id/stop", "host": [ "{{baseUrl}}" ], "path": [ "v1", "campaigns", ":id", "stop" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Stops a campaign for good. Stopping a scheduled one cancels it.\n\nPermission: A Full or Send only key." } } ] }, { "name": "Inbox", "item": [ { "name": "Assign, close or reopen a chat", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/chats/:customer/:action", "host": [ "{{baseUrl}}" ], "path": [ "v1", "chats", ":customer", ":action" ], "variable": [ { "key": "customer", "value": "" }, { "key": "action", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"member_id\": \"cm8a1b2c3d4e5f60718293a4b\"\n}", "options": { "raw": { "language": "json" } } }, "description": "action is assign, close or reopen — the app's Inbox rules. assign needs member_id (an id from GET /v1/team). close marks the chat Done; the customer writing again reopens it, or reopen does.\n\nPermission: A Full key." } }, { "name": "A customer's notes", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/notes", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "notes" ], "variable": [ { "key": "phone", "value": "" } ] }, "description": "The notes on a customer, newest first. Notes are never sent to the customer.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Add a note", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/contacts/:phone/notes", "host": [ "{{baseUrl}}" ], "path": [ "v1", "contacts", ":phone", "notes" ], "variable": [ { "key": "phone", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"text\": \"Wants delivery after 6 pm.\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Adds a note to the customer's chat (at most 2,000 characters). Never sent to the customer.\n\nPermission: A Full key." } }, { "name": "Saved replies", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/saved-replies", "host": [ "{{baseUrl}}" ], "path": [ "v1", "saved-replies" ] }, "description": "Your Inbox's saved replies.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Your team", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/team", "host": [ "{{baseUrl}}" ], "path": [ "v1", "team" ] }, "description": "The people on your team: id, name and role. Read only.\n\nPermission: Any key (Full, Send only or Read only)." } } ] }, { "name": "Messages", "item": [ { "name": "Upload a file", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/media", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media" ] }, "description": "Uploads a file once (multipart/form-data, the field file) and answers its media id, for media_id in any send. The app's own rules: pictures JPEG or PNG (HEIC and WEBP are turned into JPEG, a larger picture made smaller), videos MP4 or 3GPP, documents; the largest image 5 MB, video 16 MB, document 100 MB. For a sticker, add the field type=sticker: a WEBP file of at most 500 KB, kept as it is.\n\nPermission: A Full or Send only key." } }, { "name": "A received file", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "A file someone sent you, a file you sent (media.id on a message) or one you uploaded: its type and a signed download link that works for 15 minutes.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Download a received file", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:id/file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":id", "file" ], "query": [ { "key": "exp", "value": "", "disabled": false }, { "key": "sig", "value": "", "disabled": false } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "No key needed. The signed link stops working after a short time." } }, { "name": "A message", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/messages/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "One message: its status, price, what it was charged, its timeline, its campaign (campaign_id and campaign_reference, null when it is not a campaign message) and what was sent (text and media).\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Mark as read", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/:id/read", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", ":id", "read" ], "variable": [ { "key": "id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"typing\": true\n}", "options": { "raw": { "language": "json" } } }, "description": "Marks a message the person sent you (its id from message.received) as read — and the ones before it. Nothing is charged. typing (they also see that you are typing) is not available yet: with typing set, the answer is not_available.\n\nPermission: A Full or Send only key." } }, { "name": "Send a contact card", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/contact-card", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "contact-card" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"contacts\": [\n {\n \"name\": {\n \"formatted_name\": \"GetReply Support\"\n },\n \"phones\": [\n {\n \"phone\": \"+9198250*****\",\n \"type\": \"WORK\"\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends one or more contact cards, inside the 24-hour window. Each card is WhatsApp's contact object; name.formatted_name is needed. Not switched on for every account yet: not_available until it is.\n\nPermission: A Full or Send only key." } }, { "name": "Send buttons or a list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/interactive", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "interactive" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"body\": \"Shall we deliver today?\",\n \"buttons\": [\n {\n \"id\": \"yes\",\n \"title\": \"Yes\"\n },\n {\n \"id\": \"later\",\n \"title\": \"Later\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends up to 3 reply buttons, or a list, inside the 24-hour window. When the person taps one, you get message.received with its id.\n\nPermission: A Full or Send only key." } }, { "name": "Send a link button", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/link-button", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "link-button" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"body\": \"Track your order here.\",\n \"button_text\": \"Track order\",\n \"url\": \"https://example.com/track/4521\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends text with one button that opens a link, inside the 24-hour window. Body at most 1024 characters, button text 20, header and footer 60.\n\nPermission: A Full or Send only key." } }, { "name": "Send a location", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/location", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "location" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"latitude\": 19.076,\n \"longitude\": 72.8777,\n \"name\": \"Our shop\",\n \"address\": \"MG Road, Mumbai\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends a pin on the map, inside the 24-hour window.\n\nPermission: A Full or Send only key." } }, { "name": "Send a file", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/media", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "media" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"type\": \"document\",\n \"url\": \"https://example.com/invoice-4521.pdf\",\n \"filename\": \"invoice-4521.pdf\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends an image, video, audio or document by https link, inside the 24-hour window. Largest files: image 5 MB, video 16 MB, audio 16 MB, document 100 MB. A caption is at most 1024 characters (not for audio).\n\nPermission: A Full or Send only key." } }, { "name": "Send an OTP", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/otp", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "otp" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends a one-time code with your approved authentication template (at most 15 characters, no spaces). Leave out the template when you have exactly one.\n\nPermission: A Full or Send only key." } }, { "name": "React to a message", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/reaction", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "reaction" ] }, "body": { "mode": "raw", "raw": "{\n \"message_id\": \"cm8f1e2d3c4b5a6978695a4b3\",\n \"emoji\": \"👍\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Puts an emoji on a message the person sent you (its id from message.received). An empty emoji takes your reaction off. Inside the 24-hour window. Not switched on for every account yet: not_available until it is.\n\nPermission: A Full or Send only key." } }, { "name": "Send a sticker", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/sticker", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "sticker" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"media_id\": \"med_6f1c2e9a4b7d0c3e5a8f1b2c\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends a sticker, inside the 24-hour window: one uploaded with POST /v1/media (type=sticker), or a link to a WEBP file. Not switched on for every account yet: not_available until it is.\n\nPermission: A Full or Send only key." } }, { "name": "Send a template", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/template", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "template" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"template\": {\n \"name\": \"order_update\",\n \"language\": \"en\"\n },\n \"body\": [\n \"Riya\",\n \"#4521\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends an approved template to one person: its header (text or a file by link), one value per variable, and the values its buttons need.\n\nPermission: A Full or Send only key." } }, { "name": "Send a template test", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/test", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "test" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"template\": {\n \"name\": \"order_update\",\n \"language\": \"en\"\n },\n \"body\": [\n \"Riya\",\n \"#4521\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "The same body as Send a template. It is sent the way the app sends a campaign test: a test message (type test), priced, held and charged exactly like the app's test. No contact or chat is made.\n\nPermission: A Full or Send only key." } }, { "name": "Send a text reply", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/messages/text", "host": [ "{{baseUrl}}" ], "path": [ "v1", "messages", "text" ] }, "body": { "mode": "raw", "raw": "{\n \"to\": \"+9198250*****\",\n \"text\": \"Your order is on its way.\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends text inside the 24-hour window after the person last wrote to you (at most 4096 characters). Outside it, send a template.\n\nPermission: A Full or Send only key." } } ] }, { "name": "Templates", "item": [ { "name": "List templates", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/templates", "host": [ "{{baseUrl}}" ], "path": [ "v1", "templates" ], "query": [ { "key": "status", "value": "", "disabled": true }, { "key": "category", "value": "", "disabled": true }, { "key": "language", "value": "", "disabled": true }, { "key": "page", "value": "", "disabled": true }, { "key": "per_page", "value": "", "disabled": true } ] }, "description": "Your templates, with their status and quality.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Create a template", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/templates", "host": [ "{{baseUrl}}" ], "path": [ "v1", "templates" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"order_ready\",\n \"language\": \"en\",\n \"category\": \"utility\",\n \"body\": \"Hi {{name}}, your order is ready.\",\n \"examples\": {\n \"body:name\": \"Rohan\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Creates a template and sends it for review — the same rules as in the app. It starts as pending.\n\nPermission: A Full key." } }, { "name": "Delete a template", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/templates/:name", "host": [ "{{baseUrl}}" ], "path": [ "v1", "templates", ":name" ], "query": [ { "key": "language", "value": "", "disabled": true } ], "variable": [ { "key": "name", "value": "" } ] }, "description": "Deletes a template (one language with ?language=, or every language of the name).\n\nPermission: A Full key." } }, { "name": "A template", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/templates/:name", "host": [ "{{baseUrl}}" ], "path": [ "v1", "templates", ":name" ], "query": [ { "key": "language", "value": "", "disabled": true } ], "variable": [ { "key": "name", "value": "" } ] }, "description": "One template by name (add ?language= when it has more than one language).\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Edit a template", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/templates/:name", "host": [ "{{baseUrl}}" ], "path": [ "v1", "templates", ":name" ], "query": [ { "key": "language", "value": "", "disabled": true } ], "variable": [ { "key": "name", "value": "" } ] }, "description": "Edits a template; it goes for review again. The name, language and an approved category stay.\n\nPermission: A Full key." } } ] }, { "name": "Webhooks", "item": [ { "name": "List webhooks", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks" ] }, "description": "Your webhooks. The signing secret is never listed.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Add a webhook", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks" ] }, "body": { "mode": "raw", "raw": "{\n \"url\": \"https://example.com/whatsapp-events\",\n \"events\": [\n \"message.delivered\",\n \"message.received\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Adds an https link we post events to (at most 5). The signing secret is in this answer only.\n\nPermission: A Full key." } }, { "name": "Delete a webhook", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Deletes a webhook. Nothing is sent to it again.\n\nPermission: A Full key." } }, { "name": "A webhook's deliveries", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/deliveries", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "deliveries" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Every try of the last 7 days: the event, the status code and how long it took. Never the body.\n\nPermission: Any key (Full, Send only or Read only)." } }, { "name": "Switch a webhook on", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/enable", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "enable" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Posts a webhook.test event to the link first. Only a 2xx answer switches the webhook on; anything else leaves it as it was and answers webhook_test_failed with the status code your link gave (null when it gave none).\n\nPermission: A Full key." } }, { "name": "New signing secret", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/rotate-secret", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "rotate-secret" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Makes a new secret, shown once. The old one keeps signing for 24 hours, beside the new one.\n\nPermission: A Full key." } }, { "name": "Send a test event", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/test", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "test" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Queues a webhook.test event for this webhook.\n\nPermission: A Full key." } } ] } ] }