Get outbound assistants

Retrieve all outbound assistants for the authenticated user

GET /user/assistants/outbound

Get outbound assistants

cURL

curl --request GET \
  --url https://app.voicery.ai/api/user/assistants/outbound \
  --header 'Authorization: Bearer <token>'

200 Response

[
  {
    "id": 123,
    "user_id": 1,
    "name": "Sales Outbound Assistant",
    "type": "outbound",
    "mode": "pipeline",
    "status": "active",
    "voice_id": 8,
    "language_id": 1,
    "timezone": "America/New_York",
    "initial_message": "Hi, this is Sarah from Your Company. I hope I'm catching you at a good time. How are you doing today?",
    "system_prompt": "You are a sales representative for Your Company. Be professional, friendly, and focus on qualifying leads.",
    "variables": {
      "company_name": "Your Company",
      "product_line": "Premium Services"
    },
    "webhook_url": "https://yourcompany.com/api/webhooks/outbound-calls",
    "is_webhook_active": true,
    "created_at": "2025-07-15T14:32:15.000000Z",
    "updated_at": "2025-08-02T09:18:42.000000Z"
  },
  {
    "id": 124,
    "user_id": 1,
    "name": "Follow-up Assistant",
    "type": "outbound",
    "mode": "multimodal",
    "status": "inactive",
    "voice_id": 12,
    "language_id": 1,
    "timezone": "America/Los_Angeles",
    "initial_message": "Hello! I'm calling to follow up on our previous conversation. Do you have a few minutes to chat?",
    "system_prompt": "You are a follow-up specialist. Be warm and professional while gathering feedback and next steps.",
    "variables": {
      "purpose": "follow_up",
      "max_duration": "5_minutes"
    },
    "webhook_url": null,
    "is_webhook_active": false,
    "created_at": "2025-07-20T10:15:30.000000Z",
    "updated_at": "2025-07-25T16:45:22.000000Z"
  }
]

This endpoint returns a list of all outbound assistants belonging to the authenticated user. Outbound assistants are used for making calls to leads and prospects.

Response fields

data · array

Show properties

id · integer

The unique identifier of the assistant

user_id · integer

The ID of the user who owns this assistant

name · string

The name of the assistant

type · string

The type of assistant (will always be “outbound” for this endpoint)

mode · string

The engine mode (pipeline or multimodal)

status · string

The current status of the assistant

voice_id · integer

The ID of the voice used by the assistant

language_id · integer

The ID of the language used by the assistant

timezone · string

The timezone setting for the assistant

initial_message · string

The initial message the assistant will speak

system_prompt · string

The system prompt that defines the assistant’s behavior

variables · object

Custom variables defined for the assistant

webhook_url · string

The webhook URL for post-call notifications

is_webhook_active · boolean

Whether webhook notifications are enabled

created_at · string

The date and time when the assistant was created

updated_at · string

The date and time when the assistant was last updated

200 Response

[
  {
    "id": 123,
    "user_id": 1,
    "name": "Sales Outbound Assistant",
    "type": "outbound",
    "mode": "pipeline",
    "status": "active",
    "voice_id": 8,
    "language_id": 1,
    "timezone": "America/New_York",
    "initial_message": "Hi, this is Sarah from Your Company. I hope I'm catching you at a good time. How are you doing today?",
    "system_prompt": "You are a sales representative for Your Company. Be professional, friendly, and focus on qualifying leads.",
    "variables": {
      "company_name": "Your Company",
      "product_line": "Premium Services"
    },
    "webhook_url": "https://yourcompany.com/api/webhooks/outbound-calls",
    "is_webhook_active": true,
    "created_at": "2025-07-15T14:32:15.000000Z",
    "updated_at": "2025-08-02T09:18:42.000000Z"
  },
  {
    "id": 124,
    "user_id": 1,
    "name": "Follow-up Assistant",
    "type": "outbound",
    "mode": "multimodal",
    "status": "inactive",
    "voice_id": 12,
    "language_id": 1,
    "timezone": "America/Los_Angeles",
    "initial_message": "Hello! I'm calling to follow up on our previous conversation. Do you have a few minutes to chat?",
    "system_prompt": "You are a follow-up specialist. Be warm and professional while gathering feedback and next steps.",
    "variables": {
      "purpose": "follow_up",
      "max_duration": "5_minutes"
    },
    "webhook_url": null,
    "is_webhook_active": false,
    "created_at": "2025-07-20T10:15:30.000000Z",
    "updated_at": "2025-07-25T16:45:22.000000Z"
  }
]

Notes

• This endpoint only returns assistants with type “outbound”
• All assistants belonging to the authenticated user are returned (no pagination)
• Use these assistants with the make call endpoint to initiate outbound calls
• Outbound assistants can be used for sales calls, follow-ups, surveys, and other proactive calling scenarios