> For the complete documentation index, see [llms.txt](https://help.autorply.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.autorply.sa/start/api.md). # API Reference Complete endpoint guide with parameters, request examples

BASE URL

https://live.autorply.com/

*Public API reference snapshot • URL base updated for Autorply* ## How to use this reference Base URL: All API endpoint and platform links in this document use . Examples retain their original parameters and placeholder values. Authentication — Most requests use the apiToken parameter. Replace API-KEY with your own API key before sending a request. ## API index | 21 | WhatsApp API | WhatsApp API : Send Interactive Buttons | | -- | ------------ | ---------------------------------------------- | | 22 | WhatsApp API | WhatsApp API : Send File / Media | | 23 | WhatsApp API | WhatsApp API : Upload Media | | 24 | WhatsApp API | WhatsApp API : Get Conversation | | 25 | WhatsApp API | WhatsApp API : Get Post Back List | | 26 | WhatsApp API | WhatsApp API : Get Delivery Message Status | | 27 | WhatsApp API | WhatsApp API : Bot Template Get | | 28 | WhatsApp API | WhatsApp API : Send Broadcast Template | | 29 | WhatsApp API | WhatsApp API : Trigger Bot Flow | | 30 | WhatsApp API | WhatsApp API : Subscriber Get | | 31 | WhatsApp API | WhatsApp API : Subscriber List | | 32 | WhatsApp API | WhatsApp API : Subscriber Create | | 33 | WhatsApp API | WhatsApp API : Subscriber Update | | 34 | WhatsApp API | WhatsApp API : Delete Subscriber | | 35 | WhatsApp API | WhatsApp API : Reset User Input Flow | | 36 | WhatsApp API | WhatsApp API : Subscriber Assign Chat to Team | | 37 | WhatsApp API | WhatsApp API : Subscriber Assign Custom Fields | | 38 | WhatsApp API | WhatsApp API : Custom Fields List | | 39 | WhatsApp API | WhatsApp API : Subscriber Assign Labels | | 40 | WhatsApp API | WhatsApp API : Subscriber Remove Labels | | 41 | WhatsApp API | WhatsApp API : Subscriber Assign Sequences | | 42 | WhatsApp API | WhatsApp API : Subscriber Remove Sequences | | 43 | WhatsApp API | WhatsApp API : Add Notes To Subscriber | | 44 | WhatsApp API | WhatsApp API : Label List | | 45 | WhatsApp API | WhatsApp API : Label Create | | 46 | WhatsApp API | WhatsApp API : Catalog List | | 47 | WhatsApp API | WhatsApp Catalog : Sync | | 48 | WhatsApp API | WhatsApp API : Catalog Order List | | 49 | WhatsApp API | WhatsApp API : Catalog Order Status Change | | 50 | WhatsApp API | Autorply AI : Get Response | ## User API User API, create,update,list... ### User API : My Information My Information #### API End-point : GET/POST ``` https://live.autorply.com/api/v1/user/myInfo ``` | Parameter | Description | Type / Requirement | | --------- | ------------ | ------------------ | | apiToken | Your api key | String\|Required | #### GET Request Example #### POST Request Example ``` curl -X POST \ 'https://live.autorply.com/api/v1/user/myInfo' \ -d 'apiToken=API-KEY' ``` #### Sample Response `{"status": "1", "message": { "user_id": 114, "user_type": "Member", "name": "Member", "email": "member@gmail.com", "mobile": "3555757", "package_name": "Premium1", "expired_date": "2025-07-02 00:00:00", "created_at": "2022-03-26 10:55:29", "status": "1", "last_login_at": "2024-07-24 11:59:58", "last_login_ip": "127.0.0.1", "agent_has_ppu": "0", "agent_ppu_remaining": -1, "bot_subscriber_data": { "limit": "5000", "count": "1" }, "message_credit_data": { "limit": "unlimited", "used": 0 }, "whatsapp_bots_details": [ { "display_phone_number": "+966 55011XXXX", "phone_number_id": "11906XXXXX40020", "whatsapp_business_account_id": "10039XXXX785XX", "whatsapp_business_name": "Autorply" }] }}` ### User API : Usage Log Usage Log #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/usagelog` | Parameter | Description | Type / Requirement | | --------- | ------------ | ------------------ | | apiToken | Your api key | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/user/usage/log?apiToken=API-KEY` #### POST Request Example ``` curl -X POST \ 'https://live.autorply.com/api/v1/user/usage/log' \ -d 'apiToken=API-KEY' ``` #### Sample Response `{"status": "1", "message": { "modules": [ { "module_name": "End-user", "limit": 500, "used": 1 }, { "module_name": "Connect Account", "limit": 0, "used": 0 }, { "module_name": "Message Credit", "limit": 1458, "used": 0 }, { "module_name": "Subscribers", "limit": 0, "used": 0 }, { "module_name": "Bot Message Insight", "limit": 0, "used": 0 }, { "module_name": "Bot Conditional Reply", "limit": 0, "used": 0 }, { "module_name": "Bot AI Token", "limit": 0, "used": 0 }, { "module_name": "Input Flow Campaign", "limit": 0, "used": 0 }, { "module_name": "Live Chat", "limit": 0, "used": 0 }, { "module_name": "Live Chat - Advanced", "limit": 0, "used": 0 }, { "module_name": "Live Chat - Translator", "limit": 0, "used": 0 }, { "module_name": "Sequence Campaign", "limit": 0, "used": 0 }, { "module_name": "WhatsApp - Flows", "limit": 0, "used": 0 }, { "module_name": "WhatsApp - eCommerce Catalog", "limit": 0, "used": 0 }, { "module_name": "WhatsApp - Webhook Workflow", "limit": 0, "used": 0 }, { "module_name": "Webchat Bot", "limit": 0, "used": 0 }, { "module_name": "WhatsApp - WordPress/Shopify Integration", "limit": 0, "used": 0 }, { "module_name": "Team Member", "limit": 0, "used": 0 }, { "module_name": "API Developer", "limit": 0, "used": 0 }, { "module_name": "Live Chat Restriction", "limit": 0, "used": 0 } ], "package_name": "Premium1", "total_modules": 20 }}` ### User API : User List List of Users #### API End-point : GET/POST ``` https://live.autorply.com/api/v1/user/list ``` | Parameter | Description | Type / Requirement | | --------- | ----------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | id | Single User data can be fetched using both User ID or Email | Integer\|Optional | | limit | Fetch number of users. Default 1000, max 1000 | Number\|Optional | | offset | Page number of pagination. Default 1 | Number\|Optional | #### GET Request Example ``` https://live.autorply.com/api/v1/user/list?apiToken=API-KEY&id=USER-ID-OR-EMAIL&limit=1000&offset=1 ``` #### POST Request Example ``` curl -X POST \ 'https://live.autorply.com/api/v1/user/list' \ -d 'apiToken=API-KEY' \ -d 'id=USER-ID-OR-EMAIL' \ -d 'limit=1000' \ -d 'offset=1' ``` #### Sample Response(All list) `{"status":"1","message":[{"user_id":114,"name":"Member","email":"member@gmail.com","mobile":"017XXXXXXXX","package_name":"Premium2","expired_date":"2023-08-05 00:00:00","created_at":"2022-03-26 10:55:29","last_login_at":"2023-08-06 08:55:13","last_login_ip":"127.0.0.1"}],"nextOffset":2}` #### Sample Response(Single User) `{"status": "1", "message": { "user_id": 114, "user_type": "Member", "name": "Member", "email": "member@gmail.com", "mobile": "3555757","package_id":1, "package_name": "Premium1", "expired_date": "2025-07-02 00:00:00", "created_at": "2022-03-26 10:55:29", "status": "1", "last_login_at": "2024-07-24 11:59:58", "last_login_ip": "127.0.0.1", "agent_has_ppu": "0", "agent_ppu_remaining": -1, "bot_subscriber_data": { "limit": "5000", "count": "1" }, "message_credit_data": { "limit": "unlimited", "used": 0 }, "whatsapp_bots_details": [ { "display_phone_number": "+55011XXXX", "phone_number_id": "11906XXXXX40020", "whatsapp_business_account_id": "10039XXXX785XX", "whatsapp_business_name": "Autorply" }] }}` ### User API : User Create Create an new User #### API End-point : POST ``` https://live.autorply.com/api/v1/user/create ``` | Parameter | Description | Type / Requirement | | ------------- | -------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | name | Name of your user | String\|Required | | email | Email of your user | Email\|Required | | mobile | User phone number | String\|Optional | | password | User password | String\|Required | | package\_id | Package Id | Integer\|Required | | expired\_date | Pcakage Expired date like (2023-09-12) | String\|Required | #### GET Request Example ``` https://live.autorply.com/api/v1/user/create?apiToken=API-KEY&name=NAME&email=EMAIL&mobile=MOBILE&password=PASSWORD&package_id=NAME&expired_date=EXPIRED-DATE ``` #### POST Request Example ``` curl -X POST \ 'https://live.autorply.com/api/v1/user/create' \ -d 'apiToken=API-KEY' \ -d 'name=NAME' \ -d 'email=EMAIL' \ -d 'mobile=MOBILE' \ -d 'password=PASSWORD' \ -d 'package_id=NAME' \ -d 'expired_date=EXPIRED-DATE' ``` #### Sample Response `{"status":"1","mesasge":"User Created Successfully.","id":192}`\ `{"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."}` ### User API : User Update Update a Existing User #### API End-point : POST `https://live.autorply.com/api/v1/user/update` | Parameter | Description | Type / Requirement | | --------------------- | --------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | id | User can be updated using both User ID or Email | Integer\|Required | | name | Name of your user | String\|Optional | | email | Email of your user | Email\|Optional | | mobile | User phone number | String\|Optional | | password | User password | String\|Optional | | package\_id | Package Id | Integer\|Optional | | expired\_date | Package Expired date like (2023-09-12) | String\|Optional | | status | Status of user active(1) inactive(0) | String\|Optional | | reset\_monthly\_usage | Reset current month\`s usage log of user reset(1) keep(0) | String\|Optional | #### GET Request Example ``` https://live.autorply.com/api/v1/user/update?apiToken=API-KEY&id=USER-ID-OR-EMAIL&name=NAME&email=EMAIL&mobile=MOBILE&password=PASSWORD&package_id=NAME&expired_date=EXPIRED-DATE&status=STATUS&reset_monthly_usage=RESET-MONTHLY-USAGE ``` #### POST Request Example ``` curl -X POST \ 'https://live.autorply.com/api/v1/user/update' \ -d 'apiToken=API-KEY' \ -d 'id=USER-ID-OR-EMAIL' \ -d 'name=NAME' \ -d 'email=EMAIL' \ -d 'mobile=MOBILE' \ -d 'password=PASSWORD' \ -d 'package_id=NAME' \ -d 'expired_date=EXPIRED-DATE' \ -d 'status=STATUS' \ -d 'reset_monthly_usage=RESET-MONTHLY-USAGE' ``` #### Sample Response `{"status":"1","message":"User Updated Successfully."}`\ `{"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."}` ### User API : Package List List of Packages #### API End-point : GET/POST ``` https://live.autorply.com/api/v1/user/package/list ``` | Parameter | Description | Type / Requirement | | --------- | ------------ | ------------------ | | apiToken | Your api key | String\|Required | #### GET Request Example ``` https://live.autorply.com/api/v1/user/package/list?apiToken=API-KEY ``` #### POST Request Example ``` curl -X POST \ 'https://live.autorply.com/api/v1/user/package/list' \ -d 'apiToken=API-KEY' ``` #### Sample Response(All list) `{"status":"1","message":{"id":1,"package_name":"Basic","package_type":"subscription","price":"Trial","validity":730,"module_ids":"1,19,18,9,10,11,2,26,24,3,4,7,22,13,15","monthly_limit":"{\"1\":\"1\",\"19\":\"3000\",\"18\":\"0\",\"9\":\"2000\",\"10\":\"0\",\"11\":\"0\",\"2\":\"0\",\"26\":\"0\",\"24\":\"0\",\"3\":\"0\",\"4\":\"0\",\"7\":\"3\",\"22\":\"0\",\"13\":\"0\",\"15\":\"0\"}"}}` ### User API : Module List List of Module #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/module/list` | Parameter | Description | Type / Requirement | | --------- | ------------ | ------------------ | | apiToken | Your api key | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/user/module/list?apiToken=API-KEY` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/module/list' \`\ `-d 'apiToken=API-KEY'` #### Sample Response(All list) `{"status":"1","message":{"id":1,"module_name":"Connect Account","extra_text":"","limit_enabled":"1","status":"1"}}` ### User API : Addon List List of Addon #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/addon/list` | Parameter | Description | Type / Requirement | | --------- | ------------ | ------------------ | | apiToken | Your api key | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/user/addon/list?apiToken=API-KEY` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/addon/list' \`\ `-d 'apiToken=API-KEY'` #### Sample Response(All list) `{"status":"1","message":{"id":2,"addon_name":"Unlimited Team Member","addon_description":"Description of addon","addon_type":"recurring","price":25,"validity":30,"product_data":"{\"fastspring\":{\"product_id\":\"\",\"coupon\":\"\"},\"paypro\":{\"product_id\":\"101357\",\"coupon\":\"ADDONDEFAULT\"},\"paypal\":{\"plan_id\":\"\"},\"razorpay\":{\"plan_id\":\"\"}}","variation_data":null,"discount_data":"{\"percent\":\"\",\"terms\":\"\",\"start_date\":\"\",\"end_date\":\"2024-11-24 13:35:12\",\"timezone\":\"Asia\\/Dhaka\",\"status\":\"1\"}","visible":"1"}}` ### User API : Addon Create Create Addon #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/addon/create` #### Available Modules | SL | Module ID | Module Name | | -- | --------- | ---------------------------------------- | | 1 | 19 | Message Credit | | 1 | 1 | Connect Account | | 2 | 40 | Bot Typing On Display | | 2 | 18 | Bot AI Token | | 2 | 9 | Subscribers | | 2 | 10 | Bot Message Insight | | 2 | 11 | Bot Conditional Reply | | 3 | 2 | Input Flow Campaign | | 3 | 26 | Instagram Bot | | 3 | 44 | Incoming Message to Webhook URL | | 4 | 50 | Live Chat - Widget | | 4 | 20 | Live Chat - Advanced | | 4 | 3 | Live Chat | | 4 | 30 | Livechat - Restriction | | 4 | 24 | Live Chat - Translator | | 5 | 4 | Broadcast | | 8 | 7 | Sequence Campaign | | 9 | 43 | Social Posting | | 9 | 29 | WhatsApp Embedded Signup | | 9 | 54 | Subscribers - Delete Retention | | 9 | 28 | Comment Automation | | 11 | 23 | WhatsApp - Flows | | 11 | 47 | WhatsApp - Appointment System | | 11 | 16 | WhatsApp - Webhook Workflow | | 11 | 37 | WhatsApp - Carousel Template | | 11 | 42 | WhatsApp - Click Ads | | 11 | 21 | WhatsApp - Catalog | | 12 | 17 | WhatsApp - WordPress/Shopify Integration | | 12 | 27 | Whatsapp About Field Brand Name | | 12 | 38 | Webchat Bot | | 13 | 35 | Integration - HTTP API | | 14 | 36 | Google - Google Sheet | | 14 | 45 | Google - Google Contacts | | 14 | 46 | Google - Connect Account | | 14 | 22 | Telegram - Group Manager | | 14 | 48 | Google - Google Calendar | | 15 | 15 | API Developer | | 15 | 13 | Team Member | | 39 | 39 | Bot AI Agent | | 39 | 49 | Bot AI Assistant | | 40 | 52 | Service - Meta App Verification | | Parameter | Description | Type / Requirement | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | addon\_name | Name of your addon | String\|Required | | module\_id | Your Module ID | Int\|Required | | addon\_description | Description of your addon | String\|Required | | price | Price of your addon | Float\|Required | | validity | Validity of your addon | Int\|Required | | validity\_type | validity type can be day,week, month, year. For Day use \`D\`, For Week use \`W\`, For Month use \`M\`, For Year use \`Y\` | String\|Required | | addon\_type | You can use 2 tyepes of addon Recurring and One Time. For Recurring use \`recurring\` and For One Time use \`one-time\` | String\|Required | | extend\_value | This is Module Limit | Int\|Required | | visible | Addon visibility 1 for visible and 0 for hidden | Int\|Optional | | variation\_name | Variation name and value in json format. | Json\|Optional | | variation\_validity | Variation validity and value in json format. | Json\|Optional | | variation\_validity\_type | validity type can be day,week, month, year. For Day use \`D\`, For Week use \`W\`, For Month use \`M\`, For Year use \`Y\` | Json\|Optional | | variation\_extend\_value | This is Module Limit For Variation | Json\|Required | | variation\_price | Variation price and value in json format. | Json\|Required | #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/addon/create' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'addon_name=NAME' \`\ `-d 'module_id=MODULE-ID' \`\ `-d 'addon_description=DESCRIPTION' \`\ `-d 'price=PRICE' \`\ `-d 'validity=VALIDITY' \`\ `-d 'validity_type=D' \`\ `-d 'addon_type=one-time' \`\ `-d 'extend_value=extend_value' \`\ `-d 'visible=1' \`\ `-d 'variation_name=["variation_name1","variation_name2"]' \`\ `-d 'variation_validity=["30","60"]' \`\ `-d 'variation_validity_type=["D","M"]' \`\ `-d 'variation_extend_value=["extend_value1","extend_value2"]' \`\ `-d 'variation_price=["price1","price2"]'` #### Sample Response(All list) `{"status":"1","message":"Addon has been saved successfully.."}` ### User API : Addon Update Update Addon #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/addon/update` | Parameter | Description | Type / Requirement | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | id | Addon ID | Integer\|Required | | addon\_name | Name of your addon | String\|Required | | addon\_description | Description of your addon | String\|Optional | | price | Price of your addon | Float\|Optional | | validity | Validity of your addon | Int\|Optional | | validity\_type | validity type can be day,week, month, year. For Day use \`D\`, For Week use \`W\`, For Month use \`M\`, For Year use \`Y\` | String\|Optional | | addon\_type | You can use 2 tyepes of addon Recurring and One Time. For Recurring use \`recurring\` and For One Time use \`one-time\` | String\|Optional | | extend\_value | This is Module Limit | Int\|Optional | | visible | Addon visibility 1 for visible and 0 for hidden | Int\|Optional | | variation\_name | Variation name and value in json format. | Json\|Optional | | variation\_validity | Variation validity and value in json format. | Json\|Optional | | variation\_validity\_type | validity type can be day,week, month, year. For Day use \`D\`, For Week use \`W\`, For Month use \`M\`, For Year use \`Y\` | Json\|Optional | | variation\_extend\_value | This is Module Limit For Variation | Json\|Required | | variation\_price | Variation price and value in json format. | Json\|Required | #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/addon/update' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'id=ADDON-ID' \`\ `-d 'addon_name=NAME' \`\ `-d 'addon_description=DESCRIPTION' \`\ `-d 'price=PRICE' \`\ `-d 'validity=VALIDITY' \`\ `-d 'validity_type=D' \`\ `-d 'addon_type=one-time' \`\ `-d 'extend_value=extend_value' \`\ `-d 'visible=1' \`\ `-d 'variation_name=["variation_name1","variation_name2"]' \`\ `-d 'variation_validity=["30","60"]' \`\ `-d 'variation_validity_type=["D","M"]' \`\ `-d 'variation_extend_value=["extend_value1","extend_value2"]' \`\ `-d 'variation_price=["price1","price2"]'` #### Sample Response(All list) `{"status":"1","message":"Addon has been saved successfully."}` ### User API : Assign Addon Assign Addon #### API End-point :POST `https://live.autorply.com/api/v1/user/addon/assign` | Parameter | Description | Type / Requirement | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | user\_id | User ID | Integer\|Required | | addon\_id | Addon ID. For the main addon, use only the Addon ID (e.g., 5). For variations, use the format AddonID-Variation ID (e.g., 5-1 ), where 5 is the Addon ID and 1 is the Variation ID. | String\|Required | | expired\_date | Addon Expired date like (2023-09-12) | String\|Required | | status | Status of addon active(1) inactive(0) | Boolean\|Optional | #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/addon/assign' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'user_id=USER-ID' \`\ `-d 'addon_id=ADDON-ID' \`\ `-d 'expired_date=EXPIRED-DATE' \`\ `-d 'status=STATUS'` #### Sample Response(All list) `{"status":"1","message":"Addon has been assign successfully."}` ### User API : Addon Purchase List Addon Purchase List #### API End-point :POST `https://live.autorply.com/api/v1/user/addon/assign/list` | Parameter | Description | Type / Requirement | | --------- | -------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | user\_id | User ID. If you want to get all addon purchase data, leave it blank. | Integer\|Optional | | limit | Fetch number of addon purchases. Default 50, max 100 | Integer\|Optional | | offset | Page number of pagination. Default 1 | Integer\|Optional | GET Request Example `https://live.autorply.com/api/v1/user/addon/assign/list?apiToken=API-KEY&user_id=USER-ID&limit=50&offset=1` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/addon/assign/list' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'user_id=USER-ID' \`\ `-d 'limit=50' \`\ `-d 'offset=1'` #### Sample Response(All list) `{"status":"1","message":[{"id":122,"user_id":248,"seller_user_id":109,"purchase_date":"2025-05-24 06:14:04","addon_id":17,"expired_date":"2025-06-23 00:00:00","subscription_enabled":"0","subscription_data":null,"paypal_subscriber_id":"","paypal_next_check_time":null,"paypal_processing":"0","access_data":null,"last_payment_method":"Stripe","comment":null,"status":"1","updated_at":"2025-05-24 06:14:04","name":"sagor","email":"jondoe@gmail.com","addon_name":"Ai Addon"}],"nextOffset":2}` ### User API : Update Assign Addon Update an assigned addon purchase (expired\_date, status, variation). #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/addon/assign/update` | Parameter | Description | Type / Requirement | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | apiToken | Your api key | String\|Required | | id | Addon purchase id from Addon Purchase List response (addon\_users.id). | Integer\|Required | | user\_id | Buyer user id. Required when changing variation (addon\_id). | Integer\|Required for variation change | | addon\_id | Which addon+variation to assign: addon\_id only for main (e.g. 5), or addon\_id-variation\_index (5-0=1st variation, 5-1=2nd variation). Send with id & user\_id to change. | String\|Optional (Required for variation) | | expired\_date | New expiry date (Y-m-d). Leave blank for unlimited. | Date\|Optional | | status | 1 = active, 0 = inactive. | 0 or 1\|Optional | #### GET Request Example `https://live.autorply.com/api/v1/user/addon/assign/update?apiToken=API-KEY&id=ID&user_id=USER_ID&addon_id=5-1&expired_date=2025-12-31&status=1` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/addon/assign/update' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'id=ID' \`\ `-d 'user_id=USER_ID' \`\ `-d 'addon_id=5-1' \`\ `-d 'expired_date=2025-12-31' \`\ `-d 'status=1'` #### Sample Response (Success) `{"status":"1","message":"Addon purchase updated successfully."}` #### Sample Response (Error) `{"status":"0","message":"Addon purchase not found."}` ### User API : De-assign Addon De-assign addon purchase by purchase ID #### API End-point : GET/POST `https://live.autorply.com/api/v1/addon/purchase/delete` | Parameter | Description | Type / Requirement | | --------- | ------------------------------------------------------------------------ | ------------------ | | apiToken | Your api key | String\|Required | | id | Addon purchase ID. Get this from Addon Purchase List response. | Integer\|Required | | user\_id | Buyer user id. When only id is sent, this is resolved from addon\_users. | Integer\|Required | #### GET Request Example `https://live.autorply.com/api/v1/addon/purchase/delete?apiToken=API-KEY&id=ID&user_id=USER_ID` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/addon/purchase/delete' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'id=ID' \`\ `-d 'user_id=USER_ID'` #### Sample Response (Success) `{"status":"1","message":"Addon purchase has been deleted successfully."}` #### Sample Response (Error) `{"status":"0","message":"Addon purchase not found"}` ### User API : Get Direct Login Url An Unique and Secure One-time Login URL #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/get/direct-login-url` | Parameter | Description | Type / Requirement | | ---------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------ | | apiToken | Your api key | String\|Required | | email | Email of your user | Email\|Required | | name | Name of your user | String\|Optional | | mobile | User phone number | String\|Optional | | package\_id | Package Id | Integer\|Required for new user | | expired\_date | Package Expired date like (2023-09-12) | String\|Required for new user | | status | Status of user active(1) inactive(0) | String\|Optional | | create\_on\_fail | Set Value 1 for If user not found, create new user with this data or Set(0) it will return User not found error | Boolean\|Optional | #### GET Request Example `https://live.autorply.com/api/v1/user/get/direct-login-url?apiToken=API-KEY&email=EMAIL&name=NAME&mobile=MOBILE&package_id=NAME&expired_date=EXPIRED-DATE&status=STATUS&create_on_fail=1` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/get/direct-login-url' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'email=EMAIL' \`\ `-d 'name=NAME' \`\ `-d 'mobile=MOBILE' \`\ `-d 'package_id=NAME' \`\ `-d 'expired_date=EXPIRED-DATE' \`\ `-d 'status=STATUS' \`\ `-d 'create_on_fail=1'` #### Sample Response `{"status":"1","message":{"email":"user@domain.com","password":"xxxxxxxxxx","login_url":"https://live.autorply.com/login","direct_login_url":"https://live.autorply.com/direct-login/xxxxxxxxxx"}}` ### User API : Get direct login url only for new users Create user if not exists and return one-time direct login url. If user exists, it will return \`User already existed\`. #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/get/direct-login-url/only-new-users` | Parameter | Description | Type / Requirement | | ------------- | -------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | email | Email of your user | Email\|Required | | package\_id | Package Id | Integer\|Required | | expired\_date | Package Expired date like (2026-05-05) | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/user/get/direct-login-url/only-new-users?apiToken=API-KEY&email=EMAIL&package_id=PACKAGE-ID&expired_date=EXPIRED-DATE` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/get/direct-login-url/only-new-users' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'email=EMAIL' \`\ `-d 'package_id=PACKAGE-ID' \`\ `-d 'expired_date=EXPIRED-DATE'` #### Sample Response (Success) `{"status":"1","message":{"email":"user@domain.com","password":"xxxxxxxxxx","login_url":"https://live.autorply.com/login","direct_login_url":"https://live.autorply.com/direct-login/xxxxxxxxxx"}}` #### Sample Response (Existing User) `{"status":"0","message":"User already existed"}` ### User API : Logout User Logout user from the system #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/logout` | Parameter | Description | Type / Requirement | | --------- | --------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | user\_id | User ID of WhatsApp account owner | Integer\|Required | #### GET Request Example `https://live.autorply.com/api/v1/user/logout?apiToken=API-KEY&user_id=USER-ID` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/logout' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'user_id=USER-ID'` #### Sample Response(All list) `{"status":"1","message":"User logout from the system successfully."}` ### User API : Transaction List Transaction list from the system #### API End-point : GET/POST `https://live.autorply.com/api/v1/user/transaction/list` | Parameter | Description | Type / Requirement | | --------- | ------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | limit | Fetch number of transactions. Default 50, max 100 | Integer\|Optional | | offset | Page number of pagination. Default 1 | Integer\|Optional | #### GET Request Example `https://live.autorply.com/api/v1/user/transaction/list?apiToken=API-KEY&limit=50&offset=1` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/user/transaction/list' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'limit=50' \`\ `-d 'offset=1'` #### Sample Response(All list) `{"status":"1","message":[{"id":1,"user_id":1,"buyer_user_id":249,"verify_status":"Processed","first_name":"john doe","last_name":"","buyer_email":"johndoe@gmail.com","country":"","paid_currency":"USD","paid_at":"2025-10-13 09:20:53","payment_method":"Paypal","transaction_id":"AD1760347253249","paid_amount":0,"cycle_start_date":"2025-10-13","cycle_expired_date":null,"package_id":null,"addon_id":4,"variation_index":2,"variation_data_copy":"{\"name\":\"Webchat : unlimited website\/user\",\"validity\":\"30\",\"validity_type\":\"D\",\"extend_value\":\"0\",\"price\":\"149\",\"paypro_product_id\":\"103395\",\"fastspring_product_id\":\"\",\"paypal_plan_id\":\"\",\"razorpay_plan_id\":\"\",\"status\":\"1\"}","package_name":"Monthly Package","response_source":"","paypal_txn_type":"","invoice_url":null,"subscription_unique_id":null,"email":"johndoe@gmail.com"}],"nextOffset":2}` ## WhatsApp API WhatsApp send api, add contact... ### WhatsApp API : Account Connect Connect WhatsApp Business Account #### API End-point : POST `https://live.autorply.com/api/v1/whatsapp/account/connect` | Parameter | Description | Type / Requirement | | ------------------------------- | --------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | user\_id | User ID of WhatsApp account owner | Integer\|Required | | whatsapp\_business\_account\_id | WhatsApp Business Account ID | String\|Required | | access\_token | Access Token | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/whatsapp/account/connect?apiToken=API-KEY&user_id=USER-ID&whatsapp_business_account_id=WHATSAPP-BUSINESS-ACCOUNT-ID&access_token=ACCESS-TOKEN` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/whatsapp/account/connect' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'user_id=USER-ID' \`\ `-d 'whatsapp_business_account_id=WHATSAPP-BUSINESS-ACCOUNT-ID' \`\ `-d 'access_token=ACCESS-TOKEN'` #### Sample Response `{"status":"1","message":"Whatsapp account has been connect successfully."}` ### WhatsApp API : Send Text Message Send WhatsApp message to any mobile number #### Text vs Template Message When a user writes you on your chat service using your business number, you can reply to them through text message within 24 hours. This is known as a customer-initiated text message or session message. A WhatsApp template message, on the other hand, uses a pre-approved template for communication and is an outbound message launched by a business. You can get in touch with a user using template messages if you accidentally don\`t respond to their message within 24 hours. #### API End-point : Send Message (GET/POST) | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | message | Text message content (need url encoded value for GET request) | String\|Required | | phone\_number | Must start with country code and only numeric characters are allowed | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/whatsapp/send?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&message=TEXT-MESSAGE&phone_number=PHONE-NUMBER` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/whatsapp/send' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'phone_number_id=PHONE-NUMBER-ID' \`\ `-d 'message=TEXT-MESSAGE' \`\ `-d 'phone_number=PHONE-NUMBER'` #### Sample Response `{"status":"1", "wa_message_id":"wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=", "message":"Message sent successfully."}`\ `{"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."}` #### Generate API End-point : Send Template Message (GET/POST) Template access: Sign in to load available WhatsApp templates and generate the template-message endpoint. Select Message Template \* #### Sample Response `{"status":"1","message":"Template message sent successfully."}`\ `{"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."}` ### WhatsApp API : Send Interactive Buttons Send a session message with WhatsApp reply buttons. Optionally attach an image, video, or document as the header. Reply buttons are session messages and can be sent within the 24 hour customer service window. Send 1 to 3 buttons; each title can be up to 20 characters. To attach media, add media\_url (or media\_id) along with the buttons; allowed media headers are image, video, and document only. #### API End-point : Send Interactive Buttons (POST) | Parameter | Description | Type / Requirement | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | phone\_number | Must start with country code and only numeric characters are allowed | String\|Required | | message | Message body shown above the buttons. | String\|Required | | buttons | JSON array of 1 to 3 reply buttons. Each item can be a string or an object with id and title. Button id can be used later from webhook/button reply payload. | JSON Array\|Required | | button\_header\_text | Optional text header for the interactive message. Ignored when a media header is sent. | String\|Optional | | button\_footer\_text | Optional footer text for the interactive message. | String\|Optional | | media\_url | Public HTTPS URL of an image, video, or document to use as the interactive header. Use either media\_url or media\_id. | String\|Optional | | media\_id | WhatsApp media id obtained from the Upload Media API. When using media\_id, media\_type is required. | String\|Optional | | media\_type | Header media type. One of: image, video, document. Required when using media\_id, or when media\_url has no file extension. Audio is not supported as a header. | String\|Conditional | | media\_name | Filename to display, only used when media\_type is document. | String\|Optional | #### POST Request Example (buttons only) curl -X POST "" \\\ -H "Accept: application/json" \\\ -d "apiToken=API-KEY" \\\ -d "phone\_number\_id=PHONE-NUMBER-ID" \\\ -d "phone\_number=PHONE-NUMBER" \\\ -d "message=Would you like to continue?" \\\ -d 'buttons=\[{"id":"buy\_now","title":"Buy Now"},{"id":"details","title":"View Details"}]' \\\ -d "button\_header\_text=Product update" \\\ -d "button\_footer\_text=Tap an option" #### POST Request Example (media + buttons) curl -X POST "" \\\ -H "Accept: application/json" \\\ -d "apiToken=API-KEY" \\\ -d "phone\_number\_id=PHONE-NUMBER-ID" \\\ -d "phone\_number=PHONE-NUMBER" \\\ -d "message=Check this product and choose an action." \\\ -d "media\_url=" \\\ -d "media\_type=image" \\\ -d 'buttons=\[{"id":"buy\_now","title":"Buy Now"},{"id":"details","title":"View Details"}]' \\\ -d "button\_footer\_text=Tap an option" #### Sample Response {"status":"1", "wa\_message\_id":"wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=", "message":"Message sent successfully."}\ {"status":"0","message":"You can send between 1 and 3 reply buttons."}\ {"status":"0","message":"When sending media with buttons, media\_type must be one of: image, video, document."} ### WhatsApp API : Send File / Media Send image, video, audio, or document using only this endpoint. You must send media\_url or media\_id — at least one is required. All other fields below are optional unless noted. #### API End-point : Send File (GET/POST) | Parameter | Description | Type / Requirement | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | phone\_number | Must start with country code and only numeric characters are allowed | String\|Required | | media\_url | Public HTTPS URL of the file. WhatsApp downloads from this link. Use this when you are not using media\_id. | String\|Required if no media\_id | | media\_id | WhatsApp media id from the Upload Media API or from Graph after uploading. When using media\_id only, media\_type is required. | String\|Required if no media\_url | | media\_type | One of: image, video, audio, document. Required when using media\_id only, or when media\_url has no file extension. | String\|Conditional | | media\_caption\_text | Caption for image, video, or document (not for audio). If omitted, message is used as caption when present. | String\|Optional | #### GET Request Example #### GET example with media\_id (media\_type required) #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'media\_url=' \\\ -d 'media\_id=' \\\ -d 'media\_type=image' \\\ -d 'media\_caption\_text=' #### Sample Response {"status":"1", "wa\_message\_id":"wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=", "message":"Message sent successfully."}\ {"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."} ### WhatsApp API : Upload Media Upload a file to get media\_id and media\_type for the Send File API. #### API End-point : POST (multipart/form-data) | Parameter | Description | Type / Requirement | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------ | | apiToken | Your api key (can also be sent as Authorization: Bearer token). | String\|Required | | phone\_number\_id | WhatsApp account phone number ID (same as other WhatsApp APIs). | String\|Required | | media\_file | Multipart file field name must be media\_file. Supported types follow live chat / WhatsApp limits (image, video, audio, document). | File\|Required | #### POST Request Example curl -X POST "" \\\ -H "Authorization: Bearer API-KEY" \\\ -H "Accept: application/json" \\\ -F "phone\_number\_id=PHONE-NUMBER-ID" \\\ -F "media\_file=@/path/to/local/file.jpg" #### Sample Response {"status":"1","media\_id":"1739230482390482","media\_type":"image","message":"Upload successful. Use media\_id and media\_type with the Send File API."}\ {"status":"0","message":"..."} #### Try upload (this page) Choose which WhatsApp bot/account to upload against (media\_id is tied to that phone number id). Your API key at the top of this page is used for authentication. ### WhatsApp API : Get Conversation Get Conversation of particular subscriber #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | ----------------- | ----------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | limit | Fetch number of conversation message. (upto 50) | Number\|Required | | offset | Page number of pagination. Default 1 | Number\|Optional | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'limit=10' \\\ -d 'offset=1' #### Sample Response {"status":"1","message":\[{"id":8XX3,"whatsapp\_bot\_subscriber\_subscriber\_id":"0123456789-23","whatsapp\_bot\_id":23,"sender":"bot","agent\_name":null,"message\_content":"{\\"delay\_in\_reply\\":0,\\"messaging\_product\\":\\"whatsapp\\",\\"recipient\_type\\":\\"individual\\",\\"to\\":\\"0123456789\\",\\"type\\":\\"interactive\\",\\"interactive\\":{\\"header\\":{\\"type\\":\\"text\\",\\"text\\":\\"Order gateway\\"},\\"body\\":{\\"text\\":\\"How would you like to purchase it?\\"},\\"type\\":\\"button\\",\\"action\\":{\\"buttons\\":\[{\\"type\\":\\"reply\\",\\"reply\\":{\\"id\\":\\"5lvomLOuENXIe6D::gPeAiDDmVQR\_jTR\\",\\"title\\":\\"Paypal pay\\"}},{\\"type\\":\\"reply\\",\\"reply\\":{\\"id\\":\\"YES\_START\_CHAT\_WITH\_HUMAN::CBaLoC4yTMyIljZ\\",\\"title\\":\\"COD\\"}}]}}}","conversation\_time":"2024-07-28 13:21:03","wa\_message\_id":"wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=","reaction\_data":null,"message\_status":null,"delivery\_status\_updated\_at":"2024-07-28 13:21:03","failed\_reason":""}],"nextOffset":101} ### WhatsApp API : Get Post Back List Get Post Back List #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | ----------------- | ----------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' #### Sample Response {"status":"1","message":\[{"id":671,"user\_id":1,"postback\_id":"QUICK\_REPLY\_LOCATION\_REPLY\_BOT","whatsapp\_bot\_id":95,"use\_status":"0","status":"1","whatsapp\_bot\_setting\_id":1770,"bot\_name":"Location quick reply","is\_template":"1","template\_jsoncode":"\[{\\"messaging\_product\\":\\"whatsapp\\",\\"to\\":\\"replace\_id\\",\\"type\\":\\"text\\",\\"text\\":{\\"body\\":\\"Thank you for sharing your location. It has been received.\ Thank you for being here with us today.\\",\\"preview\_url\\":true}}]","template\_name":"Location quick reply","template\_for":"location-quick-reply","template\_id":null,"inherit\_from\_template":"0","whatsapp\_bot\_label\_ids":"","whatsapp\_bot\_remove\_label\_ids":"","remove\_sequence\_campaign\_id":0,"team\_assign\_role\_id":0,"team\_assign\_user\_id":0,"broadcast\_sequence\_campaign\_id":0,"visual\_flow\_type":"flow","postback\_type":"main","whatsapp\_bot\_visual\_flow\_builder\_campaign\_id":1358,"google\_sheet\_ids":"","updated\_at":"2024-07-14 05:25:55","row\_type":"static","custom\_field\_id":0,"custom\_field\_index":"","custom\_field\_index\_title":"","generateGoogleMeetLink":null,"googleCalendarId":null,"googleMeetToCustomFieldId":null}]} ### WhatsApp API : Get Delivery Message Status Get message statuses from API #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | ----------------- | ----------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | wa\_message\_id | WhatsApp message ID to check status | String\|Required | | whatsapp\_bot\_id | WhatsApp bot ID | Number\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'wa\_message\_id=WAMID.XXXXX' \\\ -d 'whatsapp\_bot\_id=123' #### Sample Response {"status":"1","message":{"message\_status":"delivered","delivery\_status\_updated\_at":"2024-07-28 13:21:03","read\_time":null,"failed\_time":null,"failed\_reason":""}} ### WhatsApp API : Bot Template Get Get Whatsapp Bot template #### API End-point : Get Template (GET/POST) | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' #### Sample Response {"status":"1","message":{"id":48,"template\_id":"437509121867805","whatsapp\_business\_id":11,"template\_name":"ada","template\_type":"single","locale":"en\_US","header\_type":"media","header\_subtype":"image","header\_content":"","body\_content":"To send an interactive message template, make a POST call to \\/PHONE\_NUMBER\_ID\\/","footer\_content":"","button\_content":"\[]","template\_json":"{\\"name\\":\\"template\_23\_1666095188\\",\\"language\\":\\"en\_US\\",\\"category\\":\\"transactional\\",\\"components\\":\[{\\"type\\":\\"header\\",\\"format\\":\\"image\\",\\"example\\":{\\"header\_handle\\":\[\\"https:\\\\\\/\\\\\\/example.com\\\\\\/assets\\\\\\/images\\\\\\/template\\\\\\/image.jpg\\"]}},{\\"type\\":\\"body\\",\\"text\\":\\"To send an interactive message template, make a POST call to \\\\\\/PHONE\_NUMBER\_ID\\\\\\/\\"}],\\"access\_token\\":\\"EAAHFAlhZBSyEBAIRZCsHKZA5ZAdOWMRL7AwuuCBKd3tZChAQQ1PHojPUS5k76aMVyzzxG9bYp2JQ57aLMfQBCZCpvXKac4KLDZAhejOuw1zkNCxGjvK7J5YwNmZBwTTd8Iig2YDq0vGZBoS20ipsLB4scbOOh0WmQrj7oLI9ZC5rFlsFC9mYctgQKIyJCvZBfgn5pGE1YPiBllrqwZDZD\\"}","button\_type":"none","variable\_map":"{\\"header\\":\[],\\"body\\":\[]}","updated\_at":"2022-10-18 12:13:09","user\_id":1,"status":"Rejected","system\_template":"0","map\_needed":"0","check\_wp\_type":"general"}} #### Sample Response {"status":"1","message":"Template message sent successfully."}\ {"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."} ### WhatsApp API : Send Broadcast Template Get Whatsapp Broadcast Template #### API End-point : Send Broadcast Template (GET/POST) | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | flow\_data | Pass Flow data as json format | Json\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' #### Sample Response {"status":"1","visual\_flow\_campaign\_id":1727,"message":"Data has been saved successfully.","redirect\_on\_success\_url":""} #### Sample Response {"status":"1","message":"Template message sent successfully."}\ {"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."} ### WhatsApp API : Trigger Bot Flow Trigger your bot to any mobile number #### API End-point : Trigger Bot Flow (GET/POST) | Parameter | Description | Type / Requirement | | --------------------- | -------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | bot\_flow\_unique\_id | Bot Flow Unique ID | String\|Required | | phone\_number | Must start with country code and only numeric characters are allowed | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'bot\_flow\_unique\_id=BOT-FLOW-UNIQUE-ID' \\\ -d 'phone\_number=PHONE-NUMBER' #### Sample Response {"status":"1","message":"Bot has been trigger successfully."} ### WhatsApp API : Subscriber Get Get Subscriber Using Chat ID (Phone Number #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | phone\_number | Subscriber phone number | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' #### Sample Response {"status":"1","message":\[{"subscriber\_id":144,"chat\_id":"0123456789","first\_name":"john","last\_name":"Doe","email":"","gender":"Male","created\_at":"2026-04-07 10:30:00","assigned\_agent\_id":12,"assigned\_agent":"Support Agent","bot\_reply\_label":"Bot Reply On","ai\_reply\_label":"AI Reply On","label\_names":"Label1,Label2"}]} ### WhatsApp API : Subscriber List List of Subscribers #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | limit | Fetch number of subscribers. (upto 100) | Number\|Required | | offset | Page number of pagination. Default 1 | Number\|Optional | | orderBy | Set this to 1 to sort the subscriber list by their most recent message (latest first). Set to 0 to keep the default order. | Number\|Optional | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'limit=100' \\\ -d 'offset=1' \\\ -d 'orderBy=0' #### Sample Response {"status":"1","message":\[{"subscriber\_id":144,"chat\_id":"0123456789","first\_name":"John","last\_name":"Doe","email":"","gender":"male","label\_names":"One ,two","assigned\_agent\_id":12},{"subscriber\_id":157,"chat\_id":"0123456789","first\_name":"john","last\_name":"Doe","email":"null","gender":"Male","assigned\_agent\_id":12}],"nextOffset":2} ### WhatsApp API : Subscriber Create Create a Subscriber/Contact #### API End-point : POST | Parameter | Description | Type / Requirement | | ------------- | ---------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phoneNumberID | WhatsApp account phone number ID | String\|Required | | name | Name of your subscriber | String\|Required | | phoneNumber | Subscriber phone number with country code (without + sign) | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phoneNumberID=PHONE-NUMBER-ID' \\\ -d 'name=NAME' \\\ -d 'phoneNumber=MOBILE' #### Sample Response {"status":"1","mesasge":"WhatsApp subscriber has been created."}\ {"status":"0","message":"WhatsApp account not found."}\ {"status":"0","message":"Subscriber limit has been exceeded. You cannot have more subscribers."}\ {"status":"0","message":"Something went wrong or subscriber already exist."} ### WhatsApp API : Subscriber Update Update an Existing Subscriber #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | ------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | first\_name | First name of your subscriber | String\|Optional | | last\_name | Last name of your subscriber | String\|Optional | | gender | Gender of your subscriber | String\|Optional | | label\_ids | Label ids with comma separated like (1,4,5) | String\|Optional | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'first\_name=FIRST-NAME' \\\ -d 'last\_name=LAST-NAME' \\\ -d 'gender=GENDER' \\\ -d 'label\_ids=LABEL-IDS' #### Sample Response {"status":"1","message":"Subscriber Updated Successfully."} ### WhatsApp API : Delete Subscriber Delete Whatsapp Subscriber #### API End-point : Delete Subscriber (GET/POST) | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | phone\_number | Must start with country code and only numeric characters are allowed | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' #### Sample Response {"status":"1","message":"Subscriber has been deleted successfully."} ### WhatsApp API : Reset User Input Flow Reset User Input Flow #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | WhatsApp account phone number ID | String\|Required | | phone\_number | Subscriber phone number | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' #### Sample Response {"status":"1","message":"Reset User Input Flow successfully."} ### WhatsApp API : Subscriber Assign Chat to Team Assign a Subscriber\`s Chat to a Team Member #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | ----------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | team\_member\_id | Team Member ID | Integer\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'team\_member\_id=TEAM-MEMBER-ID' #### Sample Response {"status":"1","message":"Successfully Assign Agent to Conversation."} ### WhatsApp API : Subscriber Assign Custom Fields Assign Custom Field To Subscriber #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | -------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | custom\_fields | Custom fileds name and value in json format. | JSON\|Required | #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'custom\_fields={"custom\_filed\_name1": "custom\_field\_value1","custom\_filed\_name2": "custom\_field\_value2"}' #### Sample Response {"status":"1","message":"Subscriber changes have been saved successfully."} ### WhatsApp API : Custom Fields List Get List of Custom Fields #### API End-point : POST | Parameter | Description | Type / Requirement | | --------- | ------------ | ------------------ | | apiToken | Your api key | String\|Required | #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' #### Sample Response {"status":"1","message":"Custom fields retrieved successfully","data":\[{"id":1,"name":"customer\_name","reply\_type":"text"},{"id":2,"name":"customer\_email","reply\_type":"email"}]} ### WhatsApp API : Subscriber Assign Labels Assign Labels To Subscriber #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | ------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | label\_ids | Label ids with comma separated like (1,4,5) | String\|Required | #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'label\_ids=LABEL-IDS' #### Sample Response {"status":"1","message":"Labels have been assigned successfully."} ### WhatsApp API : Subscriber Remove Labels Remove Labels To Subscriber #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | ------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | label\_ids | Label ids with comma separated like (1,4,5) | String\|Required | #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'label\_ids=LABEL-IDS' #### Sample Response {"status":"1","message":"Labels have been assigned successfully."} ### WhatsApp API : Subscriber Assign Sequences Assign Sequences To Subscriber #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | ------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | sequence\_ids | Label ids with comma separated like (1,4,5) | String\|Required | #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'sequence\_ids=SEQUENCE-IDS' #### Sample Response {"status":"1","message":"Sequences have been assigned successfully."} ### WhatsApp API : Subscriber Remove Sequences Remove Sequence To Subscriber #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | ---------------------------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | sequence\_ids | Sequence ids with comma separated like (1,4,5) | String\|Required | #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'sequence\_ids=SEQUENCE-IDS' #### Sample Response {"status":"1","message":"Sequences have been removed successfully."} ### WhatsApp API : Add Notes To Subscriber Add Notes To Subscriber #### API End-point : POST | Parameter | Description | Type / Requirement | | ----------------- | ----------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | phone\_number | Subscriber phone number | String\|Required | | note\_text | Note text | String\|Required | #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'phone\_number\_id=PHONE-NUMBER-ID' \\\ -d 'phone\_number=PHONE-NUMBER' \\\ -d 'note\_text=NOTE-TEXT' #### Sample Response {"status":"1","message":"Notes have been added successfully."} ### WhatsApp API : Label List List of Labels #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | ----------------- | ----------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/whatsapp/label/list?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/whatsapp/label/list' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'phone_number_id=PHONE-NUMBER-ID'` #### Sample Response `{"status":"1","message":[{"id":1,"label_name":"Your label name","status":"1"}]}` ### WhatsApp API : Label Create Create a Label #### API End-point : GET/POST `https://live.autorply.com/api/v1/whatsapp/label/create` | Parameter | Description | Type / Requirement | | ----------------- | ----------------------------- | ------------------ | | apiToken | Your api key | String\|Required | | phone\_number\_id | Your whatsapp phone number id | String\|Required | | label\_name | Label Name | String\|Required | #### GET Request Example `https://live.autorply.com/api/v1/whatsapp/label/create?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&label_name=LABEL-NAME` #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/whatsapp/label/create' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'phone_number_id=PHONE-NUMBER-ID' \`\ `-d 'label_name=LABEL-NAME'` #### Sample Response `{"status":"1","message":"Label has been created successfully."}` ### WhatsApp API : Catalog List Catalog List #### API End-point : GET/POST `https://live.autorply.com/api/v1/whatsapp/catalog/list` | Parameter | Description | Type / Requirement | | --------- | ------------ | ------------------ | | apiToken | Your api key | String\|Required | #### GET Request Example #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/whatsapp/catalog/list' \`\ `-d 'apiToken=API-KEY'` #### Sample Response `{"status":true,"message":[{"catalog_id":"1429267xxxx5095","catalog_name":"The White","catalog_url":"https:xxxxx","checkout_settings":"{"tax_percentage":"5.5","shipping_charge":"20"}"}]}` ### WhatsApp Catalog : Sync Catalog Sync #### API End-point : POST | Parameter | Description | Type / Requirement | | --------------------- | ------------------------ | ------------------ | | apiToken | Your api key | String\|Required | | whatsapp\_catalog\_id | Your whatsapp catalog id | String\|Required | #### POST Request Example `curl -X POST \`\ `'https://live.autorply.com/api/v1/whatsapp/catalog/sync' \`\ `-d 'apiToken=API-KEY' \`\ `-d 'whatsapp_catalog_id=WHATSAPP-CATALOG-ID'` #### Sample Response {"status":"1","message":"Catalog products have been synced successfully."} ### WhatsApp API : Catalog Order List Catalog List #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | --------------------- | ------------------------ | ------------------ | | apiToken | Your api key | String\|Required | | whatsapp\_catalog\_id | Your whatsapp catalog id | String\|Optional | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'whatsapp\_catalog\_id=WHATSAPP-CATALOG-ID' #### Sample Response `{"status":"1","message":[{"order_unique_id":"172310467380123456789","catalog_id":"762561142206860","chat_id":"0123456789","catalog_name":"Catalog Name","first_name":"John","cart_total":4300,"cart_currency":"USD","cart_status_raw":"Submitted","ordered_at":"2024-08-08 08:11:13","updated_at":"2024-08-08 08:30:40","payment_amount":4300,"payment_method":"Cash on Delivery","shipping_address":"{\"name\":\"John Doe\",\"phone_number\":\"0123456789\",\"email\":\"test@gmail.com\",\"address\":\"pti road\"}","checkout_account_email":null,"checkout_amount":"0","checkout_timestamp":null,"transaction_id":"PD1723104673012345678933FAD1","paid_at":"2024-08-08 08:30:40","status_changed_at":"2024-08-08 08:30:40"}]}` ### WhatsApp API : Catalog Order Status Change Change Catalog Order Status #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | ----------------- | ------------------------------------------------------------------------ | ------------------ | | apiToken | Your api key | String\|Required | | order\_unique\_id | Your Catalog Order ID | String\|Required | | cart\_status | Status value should be Approved\|Completed\|Shipped\|Delivered\|Refunded | String\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'order\_unique\_id=ORDER-UNIQUE-ID' \\\ -d 'cart\_status=CART-STATUS' #### Sample Response {"status":true,"message":"Cart status has been updated successfully"} ### Autorply AI : Get Response Get Response #### API End-point : GET/POST | Parameter | Description | Type / Requirement | | --------- | --------------- | ------------------ | | apiToken | Your api key | String\|Required | | param | Your Data Promt | Json\|Required | #### GET Request Example #### POST Request Example curl -X POST \\\ '' \\\ -d 'apiToken=API-KEY' \\\ -d 'param=PARAM' #### Sample Response {"status":true,"message":"Cart status has been updated successfully"}