# add call to a recurring campaign

## <mark style="color:yellow;">POST</mark> add call to campaign

```hsts
https://core-saas.voicegenie.ai/api/v1/pushCallToCampaign
```

Payload expects the following keys with headers key for <mark style="color:yellow;">Content-Type</mark> as <mark style="color:yellow;">application/json</mark> ::&#x20;

```json
{
    "token": "6756765c0000089955109cda2f0282219", //required
    "workspaceId": "65745g4s73848906c1625f", //required
    "campaignId": "637er13cb-a4f1-4fff-885fc-908asfdfc58", //required
    "customerNumber": "+10000000000", //required
    "customerInformation": { //optional
        "first_name" : "Yawar",
        "last_name" : "mushtaq"
    }
}
```

<mark style="color:yellow;">cURL</mark> request would be::

```
curl --location 'https://core-saas.voicegenie.ai/api/v1/pushCallToCampaign' \
--header 'Content-Type: application/json' \
--data '{
    "token": "6756765c0000089955109cda2f0282219", 
    "workspaceId": "65745g4s73848906c1625f", 
    "campaignId": "637er13cb-a4f1-4fff-885fc-908asfdfc58", 
    "customerNumber": "+10000000000", 
    "customerInformation": { 
        "first_name" : "Yawar",
        "last_name" : "Mushtaq"
    }
}'
```

1. <mark style="color:yellow;">token</mark>, <mark style="color:yellow;">workspaceId</mark>, <mark style="color:yellow;">campaignId</mark> and <mark style="color:yellow;">customerNumber</mark> fields and their values must be present and have string types.
2. <mark style="color:yellow;">customerNumber</mark> is the number to be called. This must have <mark style="color:yellow;">country</mark> code present with plus sign. and not have any spaces, hyphens , braces or any other chars persent.
   1. An example of accepted number would be "+10909090909"
   2. An example of rejected numbers would be "0909090909" ( missing country code), "09 09009009" (contains space), "(+109)-(090)-(0909)" (contains disallowed characters).&#x20;
3. <mark style="color:yellow;">customerInformation</mark> is optional, it has to be an object of strings. It can contain information like first\_name, last\_name etc that will be used in [dynamic variables.](https://voicegenie.gitbook.io/voicegenie-ai/product-guides/dynamic-personalization-detailed-explanation.)

<https://app.voicegenie.ai/>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://voicegenie.gitbook.io/voicegenie-ai/developer-documentation-1.0/add-call-to-a-recurring-campaign.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
