Quickstart

Setup

Navigate to the settings page in Levers app, and scroll to the API keys section. Click on Add API key.

Enter the name of the key and click Create.

Copy the client id and client secret and save it in a secure manner.

Integration

API Authentication

Learn how to authenticate your API requests using your client credentials.

Quickstart Code

Get started with sample code for making your first API call.

API Authentication

To authenticate with the Levers API, you need to obtain a bearer token using your client credentials.

Step 1: Get Your Access Token

curl -X POST https://api.dev.uselevers.com/auth/v1/api-key/auth \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "YOUR_CLIENT_ID",
    "clientSecret": "YOUR_CLIENT_SECRET"
  }'

Important Token Behavior:

Dev environment: Tokens are valid for 24 hours
Production: Tokens are valid for 5 minutes

Issuing a new token will invalidate all existing tokens for the same client. Ensure your application handles re-authentication gracefully.

Step 2: Use the Access Token

Include the access token in the Authorization header for all subsequent API requests:

Authorization: Bearer YOUR_ACCESS_TOKEN

Quickstart Code

Install the following packages:

pip install python-dotenv requests

Create a .env file in the root directory of your project and add the following variables:

CLIENT_ID=<YOUR CLIENT ID>
CLIENT_SECRET=<YOUR CLIENT SECRET>

Create main.py in the root directory of your project and copy the following code into it:

import os
import requests
from dotenv import load_dotenv

# Load environment variables
load_dotenv()


def trigger_ai_call(access_token, number_to_call):
    url = "https://api.dev.uselevers.com/api-service/v1/ai/phone-calls/action/call"

    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json"
    }

    payload = {"numberToCall": number_to_call}

    response = requests.post(url, json=payload, headers=headers)

    if response.status_code == 201:
        return response.json()
    else:
        return f"Error: {response.status_code}, {response.text}"

def authenticate_levers(api_client):
    # API endpoint
    url = "https://api.dev.uselevers.com/auth/v1/api-key/auth"

    # Get credentials from environment variables
    client_id = os.getenv("CLIENT_ID")
    client_secret = os.getenv("CLIENT_SECRET")

    # Prepare headers and payload
    headers = {
        "Content-Type": "application/json"
    }

    payload = {
        "clientId": client_id,
        "clientSecret": client_secret
    }

    # Make the POST request
    response = api_client.post(url, json=payload, headers=headers)

    # Check if request was successful
    if response.status_code == 200:
        return response.json()
    else:
        return f"Error: {response.status_code}, {response.text}"

if __name__ == "__main__":
    api_client = requests.session()
    result = authenticate_levers(api_client)
    result = trigger_ai_call(result['access_token'], "+96612341234")
    print(result)

Run the following command to execute the code:

python main.py

A contact is automatically created (or matched by phone number) the first time you call a number — there’s no separate contact-creation step. See Call single phone number for the full set of options, including linking to an existing contactUuid, promptTags, and metadata.

Integrating AI Phone Calls

Call single number

Initiate an AI call to a single phone number — best for real-time, user-triggered calls.

Call bulk numbers

Dispatch AI calls to a list of phone numbers in one request — best for outreach campaigns.

Get Started

AI Integration

Webhooks

Setup

Integration

API Authentication

Quickstart Code

API Authentication

Step 1: Get Your Access Token

Step 2: Use the Access Token

Quickstart Code

Integrating AI Phone Calls

Call single number

Call bulk numbers

​Setup

​Integration

API Authentication

Quickstart Code

​API Authentication

​Step 1: Get Your Access Token

​Step 2: Use the Access Token

​Quickstart Code

​Integrating AI Phone Calls

Call single number

Call bulk numbers

Setup

Integration

API Authentication

Step 1: Get Your Access Token

Step 2: Use the Access Token

Quickstart Code

Integrating AI Phone Calls