Attach WhatsApp number
curl --request POST \
--url http://localhost:8787/api/v1/whatsapp/agents/{agentId}/attach-number \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phoneNumberId": "<string>"
}
'import requests
url = "http://localhost:8787/api/v1/whatsapp/agents/{agentId}/attach-number"
payload = { "phoneNumberId": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({phoneNumberId: '<string>'})
};
fetch('http://localhost:8787/api/v1/whatsapp/agents/{agentId}/attach-number', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));WhatsApp Campaigns
Attach WhatsApp number
Assign a specific Meta WhatsApp sender number to an agent
POST
/
whatsapp
/
agents
/
{agentId}
/
attach-number
Attach WhatsApp number
curl --request POST \
--url http://localhost:8787/api/v1/whatsapp/agents/{agentId}/attach-number \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phoneNumberId": "<string>"
}
'import requests
url = "http://localhost:8787/api/v1/whatsapp/agents/{agentId}/attach-number"
payload = { "phoneNumberId": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({phoneNumberId: '<string>'})
};
fetch('http://localhost:8787/api/v1/whatsapp/agents/{agentId}/attach-number', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Sets the dedicated WhatsApp sender phone number override for an agent’s campaign.
Path parameters
string
required
The unique UUID of the agent.
Body parameters
string
required
The Meta
phone_number_id to use as this agent’s sender.curl -X POST https://api.agentic-os.com/api/v1/whatsapp/agents/11111111-1111-1111-1111-111111111111/attach-number \
-H "Authorization: Bearer $AGENTIC_OS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phoneNumberId": "105938472910293"
}'
import requests
response = requests.post(
"https://api.agentic-os.com/api/v1/whatsapp/agents/11111111-1111-1111-1111-111111111111/attach-number",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"phoneNumberId": "105938472910293"},
)
print(response.json())
const response = await fetch(
"https://api.agentic-os.com/api/v1/whatsapp/agents/11111111-1111-1111-1111-111111111111/attach-number",
{
method: "POST",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ phoneNumberId: "105938472910293" }),
},
);
const data = await response.json();
console.log(data);
Response
{
"id": "55555555-5555-5555-5555-555555555555",
"tenantId": "990e8400-e29b-41d4-a716-446655440000",
"agentId": "11111111-1111-1111-1111-111111111111",
"phoneNumberId": "105938472910293",
"updatedAt": "2026-06-01T12:00:00.000Z"
}
⌘I