> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://apidocs.me-mate.net/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.me-mate.net/_mcp/server. # https://business.me-mate.net/partners/broadcast/uploadsinglecontact POST https://business.me-mate.net/partners/broadcast/uploadsinglecontact Content-Type: application/json ### Purpose Uploads/adds a single contact to an existing contact list (tag/contact list ID) for partner broadcast. ### Endpoint `POST https://business.me-mate.net/partners/broadcast/uploadsinglecontact` ### Authentication This endpoint requires an auth token. * Use the existing token variable: `{{auth token}}` * Send it in the request exactly as your API expects (for example, as an `Authorization` header or another required header in your workspace/collection). > Note: This request currently references `{{auth token}}` as its authentication token variable. Ensure it is set in your active environment or globals before sending. ### Required Headers | Header | Value | Required | Notes | | ------------------ | ---------------- | -------- | ------------------------- | | `X-Requested-With` | `XMLHttpRequest` | Yes | Required by the endpoint. | *(Plus any auth header required by your backend, using* `_{{auth token}}_`*.)* ### Request Body (JSON) Content-Type: `application/json` #### Schema | Field | Type | Required | Meaning | | -------- | -------------------------- | -------- | -------------------------------------------------------------- | | `tag` | string (or numeric string) | Yes | Contact list ID (tag/list identifier) to add the contact into. | | `number` | string | Yes | Contact phone number (typically E.164 digits without spaces). | | `name` | string | Yes | Display name for the contact. | #### Example Request Body ```json { "tag": "112998", "number": "79747583534", "name": "aman waba number" } ``` ### Example Success Response (200) ```json { "status": true, "msg": "Contact added!" } ``` ### Common Error Responses (placeholders) > Exact error payloads may vary. * **400 Bad Request** — Missing/invalid fields (e.g., `tag`, `number`, `name`). * **401 Unauthorized** — Missing/invalid/expired auth token (`{{auth token}}`). * **403 Forbidden** — Auth token valid but not permitted to add contacts to the specified list. * **404 Not Found** — List/tag not found. * **409 Conflict** — Contact already exists in the list (if applicable). * **422 Unprocessable Entity** — Validation failure (number format, etc.). * **429 Too Many Requests** — Rate-limited. * **500 Internal Server Error** — Server-side error. * **503 Service Unavailable** — Temporary outage/maintenance. Reference: https://apidocs.me-mate.net/business-me-mate-net-ap-is-document-v-1-0/manage-contact/add-numbers-to-contact-list/add-single-contact/https-business-me-mate-net-partners-broadcast-uploadsinglecontact ## Request ### Headers - `X-Requested-With` (string, optional) ### Body (application/json) - `string` ## Response ### 200 OK - `msg` (string, required) - `status` (boolean, required) ## Examples **Request** ```json "{\r\n \"tag\": \"112998\", // contact list id\r\n \"number\": \"+79747583534\", // contact number\r\n \"name\": \"Aman Waba\" // contact name\r\n}" ``` **Response** ```json { "msg": "Contact added!", "status": true } ``` **SDK Code** ```python import requests url = "https://business.me-mate.net/partners/broadcast/uploadsinglecontact" payload = "{ \"tag\": \"112998\", // contact list id \"number\": \"+79747583534\", // contact number \"name\": \"Aman Waba\" // contact name }" headers = { "X-Requested-With": "XMLHttpRequest", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://business.me-mate.net/partners/broadcast/uploadsinglecontact'; const options = { method: 'POST', headers: {'X-Requested-With': 'XMLHttpRequest', 'Content-Type': 'application/json'}, body: '"{\r\n \"tag\": \"112998\", // contact list id\r\n \"number\": \"+79747583534\", // contact number\r\n \"name\": \"Aman Waba\" // contact name\r\n}"' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://business.me-mate.net/partners/broadcast/uploadsinglecontact" payload := strings.NewReader("\"{\\r\\n \\\"tag\\\": \\\"112998\\\", // contact list id\\r\\n \\\"number\\\": \\\"+79747583534\\\", // contact number\\r\\n \\\"name\\\": \\\"Aman Waba\\\" // contact name\\r\\n}\"") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-Requested-With", "XMLHttpRequest") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://business.me-mate.net/partners/broadcast/uploadsinglecontact") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-Requested-With"] = 'XMLHttpRequest' request["Content-Type"] = 'application/json' request.body = "\"{\\r\\n \\\"tag\\\": \\\"112998\\\", // contact list id\\r\\n \\\"number\\\": \\\"+79747583534\\\", // contact number\\r\\n \\\"name\\\": \\\"Aman Waba\\\" // contact name\\r\\n}\"" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://business.me-mate.net/partners/broadcast/uploadsinglecontact") .header("X-Requested-With", "XMLHttpRequest") .header("Content-Type", "application/json") .body("\"{\\r\\n \\\"tag\\\": \\\"112998\\\", // contact list id\\r\\n \\\"number\\\": \\\"+79747583534\\\", // contact number\\r\\n \\\"name\\\": \\\"Aman Waba\\\" // contact name\\r\\n}\"") .asString(); ``` ```php request('POST', 'https://business.me-mate.net/partners/broadcast/uploadsinglecontact', [ 'body' => '"{\\r\\n \\"tag\\": \\"112998\\", // contact list id\\r\\n \\"number\\": \\"+79747583534\\", // contact number\\r\\n \\"name\\": \\"Aman Waba\\" // contact name\\r\\n}"', 'headers' => [ 'Content-Type' => 'application/json', 'X-Requested-With' => 'XMLHttpRequest', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://business.me-mate.net/partners/broadcast/uploadsinglecontact"); var request = new RestRequest(Method.POST); request.AddHeader("X-Requested-With", "XMLHttpRequest"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "\"{\\r\\n \\\"tag\\\": \\\"112998\\\", // contact list id\\r\\n \\\"number\\\": \\\"+79747583534\\\", // contact number\\r\\n \\\"name\\\": \\\"Aman Waba\\\" // contact name\\r\\n}\"", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-Requested-With": "XMLHttpRequest", "Content-Type": "application/json" ] let parameters = "{ \"tag\": \"112998\", // contact list id \"number\": \"+79747583534\", // contact number \"name\": \"Aman Waba\" // contact name }" as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://business.me-mate.net/partners/broadcast/uploadsinglecontact")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```