View as Markdown
### Purpose Edit/update multiple contacts in a single contact list (tag) in one call. Each item in `contacts` identifies an existing contact by `old_number` and provides the new `number` and `name` to update. ### Endpoint `POST https://business.me-mate.net/partners/broadcast/editMultiContact` ### Authentication This endpoint requires an authenticated partner session. In this workspace, an auth token is referenced via the variable `{{access token}}`. > Configure auth at the request/collection level as required by your backend (for example, a session cookie or an Authorization header). This request currently only includes the header documented below. ### Headers | Header | Required | Value | Notes | | --- | --- | --- | --- | | `X-Requested-With` | Yes | `XMLHttpRequest` | Indicates an AJAX/XHR request. | ### Request body (JSON) Top-level body schema: | Field | Type | Required | Description | | --- | --- | --- | --- | | `contacts` | `array` | Yes | List of contact updates to apply. | ``Each `contacts[]` item:`` | Field | Type | Required | Description | | --- | --- | --- | --- | | `tag` | `string` | Yes | Contact list / tag identifier to update within (e.g., `"113050"`). All updates are applied within this list. | | `old_number` | `string` | Yes | Existing/previous contact number to locate the contact record. | | `number` | `string` | Yes | New contact number to set. | | `name` | `string` | Yes | New/updated contact name. | ### `Example payload` ``` json { "contacts": [ { "tag": "113050", "old_number": "97190xxxxx", "number": "998877xxxx", "name": "name Updated" }, { "tag": "113050", "old_number": "987654xxxxx", "number": "99999xxxx", "name": "Sales Updated" } ] } ``` ### `Validation & edge cases` - **`Number format:** Ensure `old_number` and `number` use the expected format for your account/region (digits-only vs. E.164, country code, etc.`** - **`Existence:** If `old_number` does not exist under the provided `tag`, that item may fail or be ignored depending on server behavio`** - **`Duplicates/conflicts:** If `number` already exists in the same `tag` (or violates uniqueness rules), the server may reject that updat`** - **`Partial success:** When submitting multiple items, confirm whether the API applies updates atomically or allows partial updates (some succeed, some fail). Handle accordingl`** - **`Empty list:** `contacts` should be non-empt`** ### `Typical responses` `(Exact response body may vary by deployment.)` - **`200 OK**: Updates accepted/applied successfull`** - **`400 Bad Request**: Invalid JSON/body schema, missing required fields, or failed validatio`** - **`401 Unauthorized / 403 Forbidden**: Missing/invalid auth context (token/cookie) or insufficient permission`** - **`404 Not Found**: Tag/list not found (or related resource missing`** - **`500 Internal Server Error**: Unexpected server-side erro`**

Headers

X-Requested-WithstringOptional

Request

This endpoint expects a string.

Response

OK
msgstring
failedlist of any
statusboolean
summaryobject
updatedlist of any
not_foundlist of objects
duplicateslist of any