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. Authentication

Signup

This section provides instructions on using /auth/signup endpoint to use for user signup.

Step 1: Prepare Your Request

  • Endpoint: /auth/signup

  • Method: POST

  • URL: https://api.talkstackai.com/auth/signup

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

Step 2: Create the Request Body

  • email: Email of the user.

  • password : Password for the account.

  • name : Name of the user to be registered.

Example Request Body:

{
    "email": "example@host.com",
    "password": "XXXXXXXXXX",
    "name": "John"
}

Step 3: Send the Request

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

Step 4: Handle the response

Success Response:

  • Status Code: 200 OK

  • token: The token to be used for authorization. The token is only valid for 2 hours.

  • refreshToken: Token to be used to get new token and continue session.

  • expirationTime: Time after which the token will expire.

  • signupStatus: The signup statuses are based on this enum:

    export const SIGNUP_STATUS = {
        'CREDENTIALS_MISSING': 0,
        'ACCOUNT_ALREADY_EXISTS': 1,
        'EMAIL_NOT_VERIFIED': 2,
        'SUCCESS': 3,
        'SIGNUP_FAILED': 4,
        'INVALID_EMAIL': 5,
        'EMAIL_NOT_SENT': 6
    }
  • Response Body

    {
        "message": "User registered successfully",
        "status": "success",
        "user": {
            "email": "example@host.com",
            "name": "Johm",
            "active_project": null,
            "created_at": "2025-03-10T05:20:39.831Z",
            "updated_at": "2025-03-10T05:20:39.831Z",
            "company_name": null
        },
        "signupStatus": 3
    }

Troubleshooting

  • 400 Bad Request: If the email or password or name is missing in the request or if the email is not in a valid format or if it already exists.

  • 500 Internal Server Error: For errors in signup.

Last updated 17 hours ago

PreviousGetting Started With Talkstack's APINextVerify Email

Last updated 2 months ago