Assign a phone number

curl -X POST "https://api.spyne.ai/console/v1/telephony/phone-numbers" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enterpriseId":"<enterpriseId>","teamId":"<teamId>","teamAgentMappingId":"<teamAgentMappingId>"}'

import requests

res = requests.post(
    "https://api.spyne.ai/console/v1/telephony/phone-numbers",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "enterpriseId": "<enterpriseId>",
        "teamId": "<teamId>",
        "teamAgentMappingId": "<teamAgentMappingId>",
    },
)
print(res.status_code, res.json())

const res = await fetch('https://api.spyne.ai/console/v1/telephony/phone-numbers', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_TOKEN', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    enterpriseId: '<enterpriseId>',
    teamId: '<teamId>',
    teamAgentMappingId: '<teamAgentMappingId>',
  }),
});
console.log(res.status, await res.json());

{
  "message": "Phone number provisioned successfully",
  "error": false,
  "code": "",
  "details": null,
  "data": {
    "message": "Phone number created and attached successfully",
    "status": "success",
    "provider": "twilio",
    "country": "US",
    "areaCode": null,
    "phoneNumber": "+1XXXXXXXXXX",
    "phoneNumberSid": "<phoneNumberSid>",
    "enterpriseId": "<enterpriseId>",
    "teamId": "<teamId>",
    "teamAgentMappingId": "<teamAgentMappingId>",
    "callProvider": "<callProvider>",
    "webhookOwner": "<webhookOwner>",
    "webhookUrl": "https://example.com/webhook",
    "messagingServiceSid": "<messagingServiceSid>",
    "vapiPhoneNumberId": null
  }
}

{
  "message": "Phone number provisioned successfully",
  "error": false,
  "code": "",
  "details": null,
  "data": {
    "message": "Phone number is already attached to this teamAgentMappingId",
    "status": "success",
    "alreadyExists": true,
    "created": false,
    "phoneNumber": "+1XXXXXXXXXX",
    "teamAgentMappingId": "<teamAgentMappingId>"
  }
}

{ "message": "No available phone numbers found in US", "error": true, "code": "ERROR_BAD_REQ_400", "details": null, "data": null }

{ "message": "Invalid Token", "error": true, "code": "ERROR_AUTH_401", "details": "", "data": null }

{ "message": "You cannot purchase a phone number for another enterprise.", "error": true, "code": "ERROR_FORBIDDEN_403", "details": null, "data": null }

{ "message": "That rooftop does not exist on your enterprise.", "error": true, "code": "ERROR_NOT_FOUND_404", "details": null, "data": null }

{ "message": "A phone number request for this agent is already in progress. Please wait for it to finish.", "error": true, "code": "ERROR_CONFLICT_409", "details": null, "data": null }

{ "message": "The phone number request did not complete in time. Do NOT retry immediately — check whether a number was assigned before trying again.", "error": true, "code": "ERROR_FAILED_DEPENDENCY_424", "details": null, "data": null }

{ "message": "This enterprise has purchased too many phone numbers in a short period. Please try again later.", "error": true, "code": "ERROR_TOO_MANY_REQUESTS_429", "details": null, "data": null }

{ "message": "Could not provision a phone number right now. Please try again.", "error": true, "code": "ERROR_SERVER_500", "details": null, "data": null }