Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions fern/calls/call-outbound.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,15 +12,15 @@ Vapi's outbound calling API lets you programmatically initiate single or batch c

- **Vapi Account**: Access to the Vapi Dashboard for configuration.
- **Configured Assistant**: Either a saved assistant or a transient assistant.
- **Phone Number**: Either an imported phone number from one of the supported providers or a free Vapi number. (Note: You cannot make international calls with a free Vapi number).
- **Phone Number**: Either an imported phone number from one of the supported providers. (Note: You cannot make outbound or international calls with a free Vapi number).
- **Customer's Phone Number**: The phone number that you want to call.

## Outbound Calls

You can place an outbound call from one of your phone numbers using the [`/call`](/api-reference/calls/create-phone-call) endpoint.

1. **Specify an Assistant:** you must specify either a transient assistant in the `assistant` field or reuse a saved assistant in the `assistantId` field.
2. **Get a Phone Number:** provide the `phoneNumberId` of the imported number or free Vapi number you wish to call from.
2. **Get a Phone Number:** provide the `phoneNumberId` of the imported number you wish to call from.
3. **Provide a Destination:** Finally, pass the customer's phone number or SIP URI in [`customer`](/api-reference/calls/create#request.body.customer).

Provide your authorization token and now we're ready to issue the API call!
Expand Down
1 change: 1 addition & 0 deletions fern/phone-calling.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ You can place an outbound call from one of your phone numbers using the [`/call`
- If the system message will be different with every call, specify a temporary assistant in the `assistant` field.
- To reuse an assistant, specify its ID in the `assistantId` field.
- [Read more about outbound calls](/phone-calling/outbound-calls)
- Note that outbound calling is not supported on free Vapi numbers at this time.

## Inbound calls

Expand Down
2 changes: 1 addition & 1 deletion fern/phone-numbers/free-telephony.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ This guide details how to create free phone numbers on the Vapi platform, which

- **The number is free, but calls are not.** Calls and other platform usage consume credits and are billed according to [Vapi pricing](https://vapi.ai/pricing).
- **Free Vapi numbers are for US national use.** They cannot make international calls. For international use, [import a number from another provider](/phone-numbers/import-twilio).
- **Outbound calling is limited.** Free Vapi numbers have a daily outbound-call limit. Import a number from a supported telephony provider when you need higher-volume outbound calling. See [Outbound calling](/calls/outbound-calling).
- **Outbound calling not supported.** Import a number from a supported telephony provider when you need higher-volume outbound calling. See [Outbound calling](/calls/outbound-calling).
- **Outbound Campaigns require an imported number.** Free Vapi numbers cannot be used to launch [Outbound Campaigns](/outbound-campaigns/quickstart).
- **You are responsible for lawful use.** Obtain the required consent before making outbound calls and follow applicable calling, telemarketing, and do-not-call rules. See the [TCPA consent guide](/tcpa-consent) and [Vapi Terms of Service](https://vapi.ai/terms-of-service).

Expand Down
Loading