> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/digital-agent/tools-reference/campaigns.md).

# Campaigns

Outbound campaign calls.

Outbound campaign calls. How to add a tool and use its result is described in [Tools & smart functions](https://docs.borndigital.ai/digital-agent/tools-reference.md).

| Tool                        | Technical name                | What it does                                                                                             | Languages                          |
| --------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Get campaign call metadata  | `get_campaign_call_metadata`  | Returns the metadata of the campaign call to this phone number, together with its `status_callback_url`. | cs, sk, pl, de, hr, en, ro, ru, pt |
| Update campaign call result | `update_campaign_call_result` | Update a campaign call’s status and metadata via its callback URL                                        | cs, sk, pl, de, hr, en, ro, ru, pt |

How to use them in a campaign flow is described in [Campaign smart functions](https://docs.borndigital.ai/digital-agent/campaigns/campaign-smart-functions.md).

## Get campaign call metadata

Technical name: `get_campaign_call_metadata`

Returns the metadata of the campaign call to this phone number, together with its `status_callback_url`.

* Languages: cs, sk, pl, de, hr, en, ro, ru, pt.

| Parameter                        | Name           | Required | Default | Description                                                               |
| -------------------------------- | -------------- | -------- | ------- | ------------------------------------------------------------------------- |
| Phone number                     | `phone_number` | yes      |         | A valid phone number, for example as found by the phone number extractor. |
| Number of days for user callback | `days`         | no       | `2`     | Number of days user can call back after campaign is finished              |

**Example input:** +420774072329

**Example output:**

```
{"metadata": {…}, "status_callback_url": "https://…"}
```

## Update campaign call result

Technical name: `update_campaign_call_result`

Update a campaign call’s status and metadata via its callback URL

* Languages: cs, sk, pl, de, hr, en, ro, ru, pt.

| Parameter                | Name                 | Required | Default | Description                                              |
| ------------------------ | -------------------- | -------- | ------- | -------------------------------------------------------- |
| Status                   | `status`             | yes      |         | Final status of the call                                 |
| Call metadata            | `metaData`           | no       |         | Additional metadata to attach to the call record         |
| Custom retry delay (min) | `custom_retry_delay` | no       |         | Override minutes until next campaign retry for this call |

**Example input:** This function does not use the user input utterance.

**Example output:**

```
200 - Successfully updated
```
