Talkstack
  • System architecture
  • Getting Started With Talkstack's API
  • Authentication
    • Signup
    • Verify Email
    • Resend email verification code
    • Login
    • Refresh Token
    • Change Password
    • Forgot Password
    • Reset Password
  • User
    • Generate API key
    • Set active Project
    • Get active Project
  • Project
    • Creating a new project
    • Get Project
    • Getting list of projects
    • Update a project
    • Delete Project
    • Webhook
    • Get Active Agent
    • Set Active Agent
    • Remove Active Agent
  • Agent
    • Create a new Agent
    • Get Agent Details
    • Update Agent
    • Delete an agent
    • Get All agents
  • Call
    • Make phone call
    • Get call data
    • Get call history
    • Get call analysis
    • Batch calls
  • Voices
    • List Voices
    • Get Voice data
  • Phone Number
    • Get phone number data
    • Assign Number to Agent
  • Hubspot
    • HubSpot Integration
Powered by GitBook
On this page
  1. Phone Number

Assign Number to Agent

This section provides instructions on using /phone-number/add-number endpoint to assign a phone number to agent

Step 1: Prepare Your Request

  • Endpoint: /phone-number/add-number

  • Method: POST

  • URL: https://api.talkstackai.com/phone-number/add-number

  • Headers: Include Content-Type: application/json.

  • Authorization: Bearer token or x-api-key in headers

Step 2: Create the Request Body

  • e164: The number you want to assign to the bot. The number should be verified or purchased from Twilio and should include country code. For eg: +14232324232

  • agentId: The id of the agent to which you want to assign this number.

  • projectId: the id of the project with which the agent is associated.

{
    "message": "PhoneNumber assigned successfully.",
    "status": "success"
}

Step 3: Send the Request

Use your preferred HTTP client to send the POST request with the JSON body.

Step 4: Handle the Response

The response will provide detailed information about the new agent created.

Troubleshooting

  • 400 Bad Request: If the projectId, name, systemInstruction, or phoneNumber is missing in the request.

  • 500 Internal Server Error: For errors in creating a new agent.

Last updated 15 hours ago

PreviousGet phone number dataNextHubSpot Integration

Last updated 3 months ago