[Tenjin API Reference](https://api-docs.tenjin.com/llms.txt) › Campaign Management API

- Campaign Management API OpenAPI spec: https://api-docs.tenjin.com/openapi/campaign-management-api.json

# Campaign Management API

- **OpenAPI Version:** `3.2.0`
- **API Version:** `2.1.0`

# Introduction

The Tenjin Campaign Management API is a collection of RESTful resources for your campaign configuration in
Tenjin, so you can manage it without the Tenjin dashboard. Use it to build internal tooling that automates
campaign creation and bid management.

## Access to the API

The API is served from `https://api.tenjin.com`, and every path starts with the API version, for example `https://api.tenjin.com/v2/apps`.

## Servers

- **URL:** `https://api.tenjin.com`

## Authentication

- **Bearer**: HTTP bearer (`JWT`)

  Generate an access token on the [Access Tokens](https://dashboard.tenjin.com/dashboard/access_tokens) page of the Tenjin dashboard and send it as `Authorization: Bearer <access token>`. [API access tokens](https://tenjin.com/docs/api-access-tokens/) explains them.


## Operations

### Ad Accounts

- [List ad accounts](https://api-docs.tenjin.com/campaign-management-api/get_ad_accounts.md): `GET /v2/ad_accounts`
- [Get an ad account](https://api-docs.tenjin.com/campaign-management-api/get_ad_accounts_id.md): `GET /v2/ad_accounts/{id}`

### Apps

- [List apps](https://api-docs.tenjin.com/campaign-management-api/get_apps.md): `GET /v2/apps`
- [Create an app](https://api-docs.tenjin.com/campaign-management-api/post_apps.md): `POST /v2/apps`
- [Get an app](https://api-docs.tenjin.com/campaign-management-api/get_apps_id.md): `GET /v2/apps/{id}`
- [Update an app](https://api-docs.tenjin.com/campaign-management-api/patch_apps_id.md): `PATCH /v2/apps/{id}`
- [Soft-delete an app](https://api-docs.tenjin.com/campaign-management-api/delete_apps_id.md): `DELETE /v2/apps/{id}`

### Attribution Settings

- [Get attribution settings](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_integrations_integration_id_attribution_settings.md): `GET /v2/apps/{app_id}/integrations/{integration_id}/attribution_settings`
- [Update attribution settings](https://api-docs.tenjin.com/campaign-management-api/patch_apps_app_id_integrations_integration_id_attribution_settings.md): `PATCH /v2/apps/{app_id}/integrations/{integration_id}/attribution_settings`

### Callback Group Templates

- [Get callback group templates](https://api-docs.tenjin.com/campaign-management-api/get_integrations_integration_id_callback_group_templates.md): `GET /v2/integrations/{integration_id}/callback_group_templates`

### Callback Groups

- [List callback groups for an integration and app pair](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_integrations_integration_id_callback_groups.md): `GET /v2/apps/{app_id}/integrations/{integration_id}/callback_groups`
- [Create a callback group](https://api-docs.tenjin.com/campaign-management-api/post_apps_app_id_integrations_integration_id_callback_groups.md): `POST /v2/apps/{app_id}/integrations/{integration_id}/callback_groups`
- [Get a callback group](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_integrations_integration_id_callback_groups_id.md): `GET /v2/apps/{app_id}/integrations/{integration_id}/callback_groups/{id}`
- [Update a callback group](https://api-docs.tenjin.com/campaign-management-api/patch_apps_app_id_integrations_integration_id_callback_groups_id.md): `PATCH /v2/apps/{app_id}/integrations/{integration_id}/callback_groups/{id}`

### Callback Settings

- [Get callback settings](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_integrations_integration_id_callback_settings.md): `GET /v2/apps/{app_id}/integrations/{integration_id}/callback_settings`
- [Update callback settings](https://api-docs.tenjin.com/campaign-management-api/patch_apps_app_id_integrations_integration_id_callback_settings.md): `PATCH /v2/apps/{app_id}/integrations/{integration_id}/callback_settings`

### Callback Templates

- [List callback templates for an app](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_callback_templates.md): `GET /v2/apps/{app_id}/callback_templates`
- [Get a callback template](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_callback_templates_id.md): `GET /v2/apps/{app_id}/callback_templates/{id}`

### Callbacks

- [List callbacks for an app](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_callbacks.md): `GET /v2/apps/{app_id}/callbacks`
- [Create a callback](https://api-docs.tenjin.com/campaign-management-api/post_apps_app_id_callbacks.md): `POST /v2/apps/{app_id}/callbacks`
- [Get a callback](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_callbacks_id.md): `GET /v2/apps/{app_id}/callbacks/{id}`
- [Update a callback](https://api-docs.tenjin.com/campaign-management-api/patch_apps_app_id_callbacks_id.md): `PATCH /v2/apps/{app_id}/callbacks/{id}`

### Campaigns

- [List campaigns](https://api-docs.tenjin.com/campaign-management-api/get_campaigns.md): `GET /v2/campaigns`
- [Create a campaign](https://api-docs.tenjin.com/campaign-management-api/post_campaigns.md): `POST /v2/campaigns`
- [Get a campaign](https://api-docs.tenjin.com/campaign-management-api/get_campaigns_id.md): `GET /v2/campaigns/{id}`
- [Update a campaign](https://api-docs.tenjin.com/campaign-management-api/patch_campaigns_id.md): `PATCH /v2/campaigns/{id}`
- [Soft-delete a campaign](https://api-docs.tenjin.com/campaign-management-api/delete_campaigns_id.md): `DELETE /v2/campaigns/{id}`

### Channels

- [List channels](https://api-docs.tenjin.com/campaign-management-api/get_channels.md): `GET /v2/channels`
- [Get a channel](https://api-docs.tenjin.com/campaign-management-api/get_channels_id.md): `GET /v2/channels/{id}`

### Events

- [List events for an app](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_events.md): `GET /v2/apps/{app_id}/events`

### S2S Callbacks

- [List S2S callbacks for an app](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_s2s_callbacks.md): `GET /v2/apps/{app_id}/s2s_callbacks`
- [Create an S2S callback](https://api-docs.tenjin.com/campaign-management-api/post_apps_app_id_s2s_callbacks.md): `POST /v2/apps/{app_id}/s2s_callbacks`
- [Get an S2S callback](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_s2s_callbacks_id.md): `GET /v2/apps/{app_id}/s2s_callbacks/{id}`
- [Update an S2S callback](https://api-docs.tenjin.com/campaign-management-api/patch_apps_app_id_s2s_callbacks_id.md): `PATCH /v2/apps/{app_id}/s2s_callbacks/{id}`

### SDK Keys

- [List an app's SDK keys](https://api-docs.tenjin.com/campaign-management-api/get_apps_app_id_sdk_keys.md): `GET /v2/apps/{app_id}/sdk_keys`

### SK Ad Networks

- [List SkAdNetworks](https://api-docs.tenjin.com/campaign-management-api/get_sk_ad_networks.md): `GET /v2/sk_ad_networks`
- [Get a SkAdNetwork](https://api-docs.tenjin.com/campaign-management-api/get_sk_ad_networks_id.md): `GET /v2/sk_ad_networks/{id}`