Skip to navigation
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

HeaderRequiredValueNotes
X-Requested-WithYesXMLHttpRequestIndicates an AJAX/XHR request.

Request body (JSON)

Top-level body schema:

FieldTypeRequiredDescription
contactsarrayYesList of contact updates to apply.

Each `contacts[]` item:

FieldTypeRequiredDescription
tagstringYesContact list / tag identifier to update within (e.g., "113050"). All updates are applied within this list.
old_numberstringYesExisting/previous contact number to locate the contact record.
numberstringYesNew contact number to set.
namestringYesNew/updated contact name.

Example payload

{
"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_numberandnumber use the expected format for your account/region (digits-only vs. E.164, country code, etc.

  • Existence:** If old_numberdoes not exist under the providedtag, that item may fail or be ignored depending on server behavio

  • Duplicates/conflicts:** If numberalready exists in the sametag (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