> 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/editSingleContact

POST https://business.me-mate.net/partners/broadcast/editSingleContact
Content-Type: application/json

## Purpose

Update a single contact’s phone number (and optionally display name) within a specific contact list/tag.

**Endpoint:** `POST /partners/broadcast/editSingleContact`

***

## Authentication

This endpoint typically requires an access token.

Use the existing variable:

```text
{{access token}}
```

Add it in your request auth/header as used by your API (commonly as a Bearer token):

```http
Authorization: Bearer {{access token}}
```

> If your backend expects the token in a different header/cookie, keep using the same convention used across this collection.

***

## Required Headers

| Header             | Value            | Notes                       |
| ------------------ | ---------------- | --------------------------- |
| `X-Requested-With` | `XMLHttpRequest` | Required for this endpoint. |

***

## Request Body (JSON)

Send a JSON payload with the following fields:

| Field        | Type   | Required | Notes                                                                                    |
| ------------ | ------ | -------: | ---------------------------------------------------------------------------------------- |
| `tag`        | string |      Yes | Contact list/tag identifier (e.g. contact list id). Example: `"113050"`.                 |
| `old_number` | string |      Yes | Existing/old contact phone number currently stored. Must match the record to be updated. |
| `number`     | string |      Yes | New contact phone number to set.                                                         |
| `name`       | string |     No\* | Contact display name. If provided, updates the name along with the number.               |

\*If your API enforces name, treat as required.

### Notes / Tips

* Use consistent phone number format (country code, leading zeros, etc.) per your system rules.
* If `old_number` doesn’t match an existing contact within the given `tag`, the API may return an error or a “not found” style response.

***

## Example Request

```json
{
  "tag": "113050",
  "old_number": "987654xxxx",
  "number": "7974758xxxx",
  "name": "Updated number"
}
```

***

## Example Responses

> Actual response shape can vary by deployment/version. Use the saved examples on this request as the source of truth.

### Success (200)

Common patterns include a success flag/message and/or updated contact info.

```json
{
  "success": true,
  "message": "Contact updated successfully"
}
```

### Validation Error (400)

Returned when required fields are missing/invalid.

```json
{
  "success": false,
  "message": "Validation error",
  "errors": {
    "tag": "Required",
    "number": "Invalid number format"
  }
}
```

### Unauthorized (401)

Returned when token is missing/invalid/expired.

```json
{
  "success": false,
  "message": "Unauthorized"
}
```

### Not Found / Mismatch (404)

Returned when the contact or tag cannot be found, or `old_number` does not match any contact in the list.

```json
{
  "success": false,
  "message": "Contact not found"
}
```

### Conflict / Duplicate (409)

Returned when the new `number` already exists in the same tag/list (depending on backend rules).

```json
{
  "success": false,
  "message": "Number already exists"
}
```

Reference: https://apidocs.me-mate.net/business-me-mate-net-ap-is-document-v-1-0/manage-contact/edit-numbers-inside-contact-lists/single/https-business-me-mate-net-partners-broadcast-edit-single-contact

## Request

### Headers

- `X-Requested-With` (string, optional)

### Body (application/json)

- `string`

## Response

### 200

OK

- `error` (string, required)
- `status` (boolean, required)

## Examples

**Request**

```json
"{\r\n    \"tag\": \"113050\",   // contact list id\r\n    \"old_number\": \"987654xxxx\", // old contact number\r\n    \"number\": \"7974758xxxx\", // new contact number\r\n    \"name\": \"Updated number\"  // contact user name\r\n}"
```

**Response**

```json
{
  "error": "Contact not found.",
  "status": false
}
```

**SDK Code**

```python
import requests

url = "https://business.me-mate.net/partners/broadcast/editSingleContact"

payload = "{
    \"tag\": \"113050\",   // contact list id
    \"old_number\": \"987654xxxx\", // old contact number
    \"number\": \"7974758xxxx\", // new contact number
    \"name\": \"Updated number\"  // contact user 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/editSingleContact';
const options = {
  method: 'POST',
  headers: {'X-Requested-With': 'XMLHttpRequest', 'Content-Type': 'application/json'},
  body: '"{\r\n    \"tag\": \"113050\",   // contact list id\r\n    \"old_number\": \"987654xxxx\", // old contact number\r\n    \"number\": \"7974758xxxx\", // new contact number\r\n    \"name\": \"Updated number\"  // contact user 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/editSingleContact"

	payload := strings.NewReader("\"{\\r\\n    \\\"tag\\\": \\\"113050\\\",   // contact list id\\r\\n    \\\"old_number\\\": \\\"987654xxxx\\\", // old contact number\\r\\n    \\\"number\\\": \\\"7974758xxxx\\\", // new contact number\\r\\n    \\\"name\\\": \\\"Updated number\\\"  // contact user 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/editSingleContact")

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\\\": \\\"113050\\\",   // contact list id\\r\\n    \\\"old_number\\\": \\\"987654xxxx\\\", // old contact number\\r\\n    \\\"number\\\": \\\"7974758xxxx\\\", // new contact number\\r\\n    \\\"name\\\": \\\"Updated number\\\"  // contact user 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<String> response = Unirest.post("https://business.me-mate.net/partners/broadcast/editSingleContact")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Content-Type", "application/json")
  .body("\"{\\r\\n    \\\"tag\\\": \\\"113050\\\",   // contact list id\\r\\n    \\\"old_number\\\": \\\"987654xxxx\\\", // old contact number\\r\\n    \\\"number\\\": \\\"7974758xxxx\\\", // new contact number\\r\\n    \\\"name\\\": \\\"Updated number\\\"  // contact user name\\r\\n}\"")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://business.me-mate.net/partners/broadcast/editSingleContact', [
  'body' => '"{\\r\\n    \\"tag\\": \\"113050\\",   // contact list id\\r\\n    \\"old_number\\": \\"987654xxxx\\", // old contact number\\r\\n    \\"number\\": \\"7974758xxxx\\", // new contact number\\r\\n    \\"name\\": \\"Updated number\\"  // contact user 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/editSingleContact");
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\\\": \\\"113050\\\",   // contact list id\\r\\n    \\\"old_number\\\": \\\"987654xxxx\\\", // old contact number\\r\\n    \\\"number\\\": \\\"7974758xxxx\\\", // new contact number\\r\\n    \\\"name\\\": \\\"Updated number\\\"  // contact user 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\": \"113050\",   // contact list id
    \"old_number\": \"987654xxxx\", // old contact number
    \"number\": \"7974758xxxx\", // new contact number
    \"name\": \"Updated number\"  // contact user name
}" as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://business.me-mate.net/partners/broadcast/editSingleContact")! 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()
```