> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Vibe

The Vibe connector lets your AI agent act in each user's Vibe account. Each user signs in to Vibe once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 34 tools.

**Authentication:** OAuth 2.0
**Categories:** Marketing
**Tools:** 34: 21 read, 9 write, 4 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Vibe app
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=VIBE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Vibe connection

   In **AgentKit > Connections**, create a Vibe connection and copy its redirect URI. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Register an OAuth app

   Vibe connections use your own OAuth app. Register one with Vibe and add the redirect URI you copied.

   Then enter the app's Client ID and Client Secret on the Vibe connection.

5. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'vibe'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Vibe:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'vibe_get_account_balance',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "vibe"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Vibe:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="vibe_get_account_balance",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'vibe_get_account_balance',
  toolInput: {},
  connector: 'vibe',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="vibe_get_account_balance",
    tool_input={},
    connection_name="vibe",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `vibe_get_account_balance`

Get Account Balance · Read-only

Get the current billing balance of the authenticated Vibe account.
Returns the account id, currency, balance in cents (balance_cents) and when it was last updated. The balance is Vibe's authoritative running total of what is owed, so it is not expected to match a sum of individual billing operations exactly.
Use this for the amount owed right now; to browse individual invoices, use vibe_list_invoices.
Requires the billing:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vibe_get_advertiser`

Get Advertiser · Read-only

Get one Vibe advertiser by its ID.
Returns the advertiser's id, name, url, industry, apps (app_id and os), and created/updated timestamps.
Use this when you already have the advertiser ID; to search or browse advertisers, use vibe_list_advertisers. Requires the advertisers:read scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `advertiser_id` (`string`, required): UUID of the advertiser to retrieve. Get it from vibe_list_advertisers. Example: 8a1c4d2e-6b3f-4a9d-b7e5-2f1c0d9e8a7b.

Example input: `{"advertiser_id":"<advertiser_id>"}`

### `vibe_get_audience`

Get Audience · Read-only

Get a single persistent Vibe audience by its ID.
Returns the audience's id, advertiser id, name, display name, description, external audience key, status (ACTIVE or INACTIVE), and created and updated timestamps.
Use this when you already have an audience_id; to find the audiences of an advertiser, use vibe_list_audiences.
Requires the audiences:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `audience_id` (`string`, required): Stable identifier of the audience to retrieve. Required. Take it from the id field returned by vibe_list_audiences. Example: 3f2a9b64-8d1e-4c07-b5a3-6e7d0c1f2a98.

Example input: `{"audience_id":"<audience_id>"}`

### `vibe_get_campaign`

Get Campaign · Read-only

Get one Vibe campaign by its ID.
Returns the campaign's id, advertiser_id, name, goal, status, state, active, attribution_window_in_hours, optimization_goal, start/end dates and budget (derived from its strategies), publication_date, and created/updated timestamps.
Use this when you already have the campaign ID; to search or browse campaigns, use vibe_list_campaigns. Requires the campaigns:read scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): UUID of the campaign to retrieve. Get it from vibe_list_campaigns or from the id returned when the campaign was created. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b.

Example input: `{"campaign_id":"<campaign_id>"}`

### `vibe_get_strategy`

Get Strategy · Read-only

Get one Vibe strategy by its id.
Returns the strategy's campaign_id, name, budget, budget_type, starts_at, ends_at, active flag, review state (AUTHORIZED, BLOCKED or PENDING_REVIEW), targeting object, creative_ids and timestamps.
Use this when you already have a strategy id; use vibe_list_strategies to find strategies and vibe_list_strategy_creatives for full creative records (a strategy only carries creative ids).
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `strategy_id` (`string`, required): UUID of the Vibe strategy to retrieve. Get it from vibe_list_strategies, or from the id returned by vibe_create_strategy.

Example input: `{"strategy_id":"<strategy_id>"}`

### `vibe_list_accounts`

List Accounts · Read-only

List the Vibe accounts the connected app can access.
Returns a plain array (no pagination) with each account's id, name, currency, timezone, status (ACTIVE, BLOCKED, or ONBOARDING), and created/updated timestamps.
Use this to see which accounts the app can act on; to browse the advertisers inside the account, use vibe_list_advertisers. Requires the account:read scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vibe_list_advertisers`

List Advertisers · Read-only

List the advertisers in the Vibe account, optionally filtered by ID, name, or URL.
Returns a page with data, total, limit, and offset; each advertiser has id, name, url, industry, apps (app_id and os), and created/updated timestamps.
Use this to browse or find an advertiser ID; to fetch one advertiser by ID, use vibe_get_advertiser, and to see its campaigns, use vibe_list_campaigns. Requires the advertisers:read scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, optional): Return only the advertiser with this UUID. Example: 8a1c4d2e-6b3f-4a9d-b7e5-2f1c0d9e8a7b. To fetch a single advertiser by ID, vibe_get_advertiser is more direct.
- `limit` (`integer`, optional): Maximum number of advertisers to return in one page. Defaults to 20; Vibe's pagination guide sets a maximum of 5000. Combine with offset to page through results. Default: `20`.
- `name` (`string`, optional): Case-insensitive 'contains' filter on the advertiser name. Example: acme.
- `offset` (`integer`, optional): Number of advertisers to skip before returning results, for paging. Defaults to 0. For the next page, add the previous limit to the previous offset; stop when offset reaches the total in the response. Default: `0`.
- `url` (`string`, optional): Case-insensitive 'contains' filter on the advertiser URL. Example: acme.com.

Example input: `{}`

### `vibe_list_age_ranges`

List Age Ranges · Read-only

List the age ranges that can be targeted in a Vibe strategy.
Returns the complete list with no pagination, each with an id (RANGE_18_20, RANGE_21_24, RANGE_25_34, RANGE_35_44, RANGE_45_54, RANGE_55_64 or RANGE_65_MORE) and a display name.
Use this to look up age-range IDs for strategy targeting; for gender use vibe_list_genders, and for other demographic segments use vibe_list_demographics. The catalog updates weekly, so cache the result for at least 24 hours.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vibe_list_audiences`

List Audiences · Read-only

List the persistent audiences that belong to one Vibe advertiser, with offset pagination.
Returns each audience's id, advertiser id, application id, name, external audience key and status (ACTIVE or INACTIVE), plus total, limit and offset.
Use this to browse an advertiser's audiences; to fetch one audience's full detail (display name, description, created and updated times), use vibe_get_audience. Get the advertiser_id from vibe_list_advertisers.
Requires the audiences:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `advertiser_id` (`string`, required): Stable identifier of the advertiser whose audiences to list. Required. Use vibe_list_advertisers to find it. Example: 7c1d8e52-3b9a-4f64-a1d2-9e0b5c3f1a77.
- `limit` (`integer`, optional): Maximum number of audiences to return in one page, as an integer of at least 1. The Vibe pagination guide caps limit at 5000 for list endpoints. Defaults to 20. Use together with offset to page through results; the response reports total, limit and offset. Default: `20`.
- `offset` (`integer`, optional): Number of audiences to skip before returning results, as an integer of at least 0. Defaults to 0. Increase it by the previous limit to fetch the next page. Default: `0`.

Example input: `{"advertiser_id":"<advertiser_id>"}`

### `vibe_list_campaign_creatives`

List Campaign Creatives · Read-only

List the creatives attached to one Vibe campaign.
Returns a page with data, total, limit, and offset; each creative has id, advertiser_id, name, type (VIDEO or VAST), asset_url, vast_tag_url, approval_status (PROCESSING, PENDING_REVIEW, AUTHORIZED, or BLOCKED), approval_details, and created/updated timestamps.
Use this for the creatives of a single campaign; to list creatives across the account, use vibe_list_creatives. Requires the creatives:read scope, not campaigns:read.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): UUID of the campaign to list creatives for. Get it from vibe_list_campaigns or from the id returned when the campaign was created. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b.
- `limit` (`integer`, optional): Maximum number of creatives to return in one page. Defaults to 20; Vibe's pagination guide sets a maximum of 5000. Combine with offset to page through results. Default: `20`.
- `offset` (`integer`, optional): Number of creatives to skip before returning results, for paging. Defaults to 0. For the next page, add the previous limit to the previous offset; stop when offset reaches the total in the response. Default: `0`.

Example input: `{"campaign_id":"<campaign_id>"}`

### `vibe_list_campaigns`

List Campaigns · Read-only

List the campaigns in the Vibe account, optionally filtered by ID, advertiser, status, or a name search.
Returns a page with data, total, limit, and offset; each campaign has id, advertiser_id, name, goal, status, state, active, attribution_window_in_hours, optimization_goal, start/end dates, budget, publication_date, and created/updated timestamps.
Use this to browse or find campaigns; to fetch one campaign by ID, use vibe_get_campaign. Requires the campaigns:read scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `advertiser_id` (`string`, optional): Return only campaigns that belong to this advertiser UUID. Get it from vibe_list_advertisers. Example: 8a1c4d2e-6b3f-4a9d-b7e5-2f1c0d9e8a7b.
- `id` (`string`, optional): Return only the campaign with this UUID. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b. To fetch a single campaign by ID, vibe_get_campaign is more direct.
- `limit` (`integer`, optional): Maximum number of campaigns to return in one page. Defaults to 20; Vibe's pagination guide sets a maximum of 5000. Combine with offset to page through results. Default: `20`.
- `offset` (`integer`, optional): Number of campaigns to skip before returning results, for paging. Defaults to 0. For the next page, add the previous limit to the previous offset; stop when offset reaches the total in the response. Default: `0`.
- `search` (`string`, optional): Case-insensitive 'contains' search on the campaign name; at least 2 characters. Example: spring.
- `status` (`array`, optional): Filter by campaign status; pass several values to combine them. Allowed values: DRAFT, UPCOMING_OR_DELIVERING, PAUSED, ARCHIVED, COMPLETED, BLOCKED. These filter values are not the same as the status (DRAFT, PUBLISHED, ARCHIVED, DELETED) and state fields on the returned campaigns. Example: ["DRAFT", "PAUSED"].

Example input: `{}`

### `vibe_list_channels`

List Channels · Read-only

List the apps, channels and live-sports inventory that can be targeted in a Vibe strategy, optionally filtered by inventory type, category or name, with offset pagination.
Returns each channel's id, name, description, type (CHANNEL or LIVE_SPORT), categories, logo URLs, whether it has a landing page, whether it is deprecated, and the advertiser categories allowed to target it, plus total, limit and offset.
Use this to look up channel IDs for strategy targeting; for locations use vibe_search_geolocations, for devices use vibe_list_devices, and for interest audiences use vibe_list_interest_segments. The catalog updates weekly, so cache the result for at least 24 hours.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category` (`string`, optional): Filter by category name, for example Sports. Matches the category names that appear in each channel's categories list. If omitted, all categories are returned.
- `deprecated` (`boolean`, optional): Set to true to include deprecated channels in the results. If omitted, deprecated channels are left out (the API default is false).
- `limit` (`integer`, optional): Maximum number of channels to return in one page, as an integer of at least 1. The Vibe pagination guide caps limit at 5000 for list endpoints. If omitted, the API default applies. Use together with offset to page through results; the response reports total, limit and offset.
- `offset` (`integer`, optional): Number of channels to skip before returning results, as an integer of at least 0. If omitted, the API starts at the first item. Increase it by the previous limit to fetch the next page.
- `search` (`string`, optional): Case-insensitive search of channels by name, for example hulu. If omitted, no name filter is applied.
- `type` (`string`, optional): Filter by inventory type. Valid values are APPS_AND_CHANNELS and LIVE_SPORTS. If omitted, both are returned. One of: `APPS_AND_CHANNELS`, `LIVE_SPORTS`.

Example input: `{}`

### `vibe_list_creatives`

List Creatives · Read-only

List the creatives (video files or VAST tags) in the connected Vibe account, optionally filtered by advertiser.
Returns a page of creatives (id, advertiser_id, name, type VIDEO or VAST, asset_url, vast_tag_url, approval_status, approval_details, timestamps) with total, limit and offset.
Use this to browse all creatives or find creative ids; use vibe_list_strategy_creatives or vibe_list_campaign_creatives for the creatives attached to a specific strategy or campaign.
Requires the creatives:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `advertiser_id` (`string`, optional): UUID of an advertiser; returns only that advertiser's creatives. Get it from vibe_list_advertisers. Leave it out to list creatives across advertisers.
- `limit` (`integer`, optional): Maximum number of creatives to return in one page, from 1 to 5000. The API default is 20. Combine with offset to page through results, for example limit 50 with offset 100 returns items 101 to 150. Default: `20`.
- `offset` (`integer`, optional): Number of creatives to skip before returning results, 0 or greater. The API default is 0. Increase it by the limit value to fetch the next page. Default: `0`.

Example input: `{}`

### `vibe_list_demographics`

List Demographics · Read-only

List the demographic segments that can be targeted in a Vibe strategy, grouped by category.
Returns the complete list with no pagination, each with an id, name and category.
Use this to look up demographic segment IDs for strategy targeting; age ranges and genders have their own tools, vibe_list_age_ranges and vibe_list_genders, and interest audiences are in vibe_list_interest_segments. The catalog updates weekly, so cache the result for at least 24 hours.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vibe_list_devices`

List Devices · Read-only

List the device types that can be targeted in a Vibe strategy.
Returns the complete list with no pagination, each with an id (TV, TABLET or MOBILE) and a display name.
Use this to look up device IDs for strategy targeting; for channels and apps use vibe_list_channels, and for locations use vibe_search_geolocations. The catalog updates weekly, so cache the result for at least 24 hours.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vibe_list_genders`

List Genders · Read-only

List the genders that can be targeted in a Vibe strategy.
Returns the complete list with no pagination, each with an id (MALE or FEMALE) and a display name.
Use this to look up gender IDs for strategy targeting; for age use vibe_list_age_ranges, and for other demographic segments use vibe_list_demographics. The catalog updates weekly, so cache the result for at least 24 hours.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vibe_list_interest_segments`

List Interest Segments · Read-only

List the audience interest segments that can be targeted in a Vibe strategy, optionally filtered by name, with offset pagination.
Returns each segment's id, name, parent and size, plus total, limit and offset.
Use this to look up interest segment IDs for strategy targeting; for age, gender and other demographic segments use vibe_list_age_ranges, vibe_list_genders and vibe_list_demographics. The catalog updates weekly, so cache the result for at least 24 hours.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of interest segments to return in one page, as an integer of at least 1. The Vibe pagination guide caps limit at 5000 for list endpoints. If omitted, the API default applies. Use together with offset to page through results; the response reports total, limit and offset.
- `offset` (`integer`, optional): Number of interest segments to skip before returning results, as an integer of at least 0. If omitted, the API starts at the first item. Increase it by the previous limit to fetch the next page.
- `search` (`string`, optional): Case-insensitive search of interest segments by name, for example travel. If omitted, no name filter is applied.

Example input: `{}`

### `vibe_list_invoices`

List Invoices · Read-only

List the invoices of the authenticated Vibe account, optionally filtered by status, with offset pagination.
Returns each invoice's id, status (open, failed, paid or void), currency, amount and amount paid in cents, payment retry count, and created and paid timestamps, plus total, limit and offset.
Use this to browse billing history; for the amount currently owed, use vibe_get_account_balance.
Requires the billing:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of invoices to return in one page, as an integer of at least 1. Maximum 100. Defaults to 20. Use together with offset to page through results; the response reports total, limit and offset. Default: `20`.
- `offset` (`integer`, optional): Number of invoices to skip before returning results, as an integer of at least 0. If omitted, the API starts at the first item. Increase it by the previous limit to fetch the next page.
- `status` (`string`, optional): Only return invoices with this status. Valid values are open, failed, paid and void. If omitted, invoices of every status are returned. One of: `open`, `failed`, `paid`, `void`.

Example input: `{}`

### `vibe_list_strategies`

List Strategies · Read-only

List the strategies in the connected Vibe account, optionally filtered by campaign, advertiser, active flag, or start and end date-time.
Returns a page of strategies (id, campaign_id, name, budget, budget_type, starts_at, ends_at, active, review state, targeting, creative_ids, timestamps) with total, limit and offset.
Use this to browse strategies; use vibe_get_strategy for one strategy by id, vibe_list_strategy_creatives for the creative records attached to a strategy, or vibe_list_campaigns for campaigns.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `active` (`boolean`, optional): Filter by delivery state: true returns only active strategies and false returns only inactive ones. Leave it out to return both.
- `advertiser_id` (`string`, optional): UUID of an advertiser; returns only strategies for that advertiser. Get it from vibe_list_advertisers.
- `campaign_id` (`string`, optional): UUID of a campaign; returns only strategies in that campaign. Get it from vibe_list_campaigns.
- `ends_at` (`string`, optional): Filter by strategy end date-time, as an ISO 8601 date-time such as 2026-12-01T00:00:00Z. The Vibe reference does not say whether this matches exactly or as a bound.
- `limit` (`integer`, optional): Maximum number of strategies to return in one page, from 1 to 5000. The API default is 20. Combine with offset to page through results, for example limit 50 with offset 100 returns items 101 to 150. Default: `20`.
- `offset` (`integer`, optional): Number of strategies to skip before returning results, 0 or greater. The API default is 0. Increase it by the limit value to fetch the next page. Default: `0`.
- `starts_at` (`string`, optional): Filter by strategy start date-time, as an ISO 8601 date-time such as 2026-11-01T00:00:00Z. The Vibe reference does not say whether this matches exactly or as a bound.

Example input: `{}`

### `vibe_list_strategy_creatives`

List Strategy Creatives · Read-only

List the creatives attached to one Vibe strategy.
Returns a page of creatives (id, advertiser_id, name, type VIDEO or VAST, asset_url, vast_tag_url, approval_status, approval_details, timestamps) with total, limit and offset.
Use this for the creatives of a single strategy; use vibe_list_creatives for all creatives (optionally by advertiser), vibe_list_campaign_creatives for a campaign's creatives, or vibe_get_strategy for just the creative ids.
Requires the creatives:read OAuth scope and a strategy id from vibe_list_strategies.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `strategy_id` (`string`, required): UUID of the Vibe strategy to list creatives for. Get it from vibe_list_strategies, or from the id returned by vibe_create_strategy.
- `limit` (`integer`, optional): Maximum number of creatives to return in one page, from 1 to 5000. The API default is 20. Combine with offset to page through results, for example limit 50 with offset 100 returns items 101 to 150. Default: `20`.
- `offset` (`integer`, optional): Number of creatives to skip before returning results, 0 or greater. The API default is 0. Increase it by the limit value to fetch the next page. Default: `0`.

Example input: `{"strategy_id":"<strategy_id>"}`

### `vibe_search_geolocations`

Search Geolocations · Read-only

Search or browse the geographic locations that can be targeted in a Vibe strategy: regions, metros, cities, ZIP codes, counties and congressional districts.
Returns each location's id, label, reach and type, plus total, limit and offset.
Use this to look up location IDs for strategy targeting. At least one of type or search is required: set type to browse every location of that type with pagination, or set search (minimum 2 characters) to match labels across all types, in which case offset is ignored. The catalog updates weekly, so cache the result for at least 24 hours.
Requires the campaigns:read OAuth scope.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deprecated` (`boolean`, optional): Set to true to include deprecated locations. This only applies to REGION and CITY locations. Defaults to false. Default: `false`.
- `limit` (`integer`, optional): Maximum number of locations to return in one page, as an integer of at least 1. Maximum 100. Defaults to 20. Use together with offset to page through results; the response reports total, limit and offset. Default: `20`.
- `offset` (`integer`, optional): Number of locations to skip before returning results, as an integer of at least 0. Defaults to 0. Ignored when searching without a type. Increase it by the previous limit to fetch the next page. Default: `0`.
- `search` (`string`, optional): Case-insensitive search on the location label, minimum 2 characters, for example austin. Required when type is not provided. When type is also set, the search is restricted to that type; without type, results span all location types and offset is ignored.
- `type` (`string`, optional): Location type to browse. Valid values are REGION, METRO, CITY, ZIPCODE, COUNTY and CONGRESSIONAL_DISTRICT. At least one of type or search must be provided. When type is set, search is optional and, if omitted, every location of that type is returned page by page. One of: `REGION`, `METRO`, `CITY`, `ZIPCODE`, `COUNTY`, `CONGRESSIONAL_DISTRICT`.

Example input: `{}`

### `vibe_campaign_action`

Perform Campaign Action · Write

Pause or reactivate a published Vibe campaign.
Returns the updated campaign. PAUSE stops delivery and ACTIVATE resumes it. PAUSE is rejected once the campaign has passed its end date, and invalid state transitions return 422.
Use this to pause or reactivate a campaign. To publish a draft campaign, use vibe_publish_campaign, which needs the campaigns:publish scope. This tool requires the campaigns:write scope.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Lifecycle action to perform: PAUSE stops delivery of a published campaign and ACTIVATE resumes it. One of: `PAUSE`, `ACTIVATE`.
- `campaign_id` (`string`, required): UUID of the campaign to act on. Get it from vibe_list_campaigns or from the id returned when the campaign was created. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b.

Example input: `{"action":"PAUSE","campaign_id":"<campaign_id>"}`

### `vibe_create_campaign`

Create Campaign · Write

Create a Vibe campaign in DRAFT status for an advertiser, with a goal, an optimization goal, and target countries.
Returns the created campaign with its id, status, state, and settings. Nothing is delivered or spent until the campaign is published, and strategies (budget, schedule, targeting) are added separately.
Use this to start a new campaign; to copy an existing one, use vibe_duplicate_campaign, and to go live, use vibe_publish_campaign. Requires the campaigns:write scope.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `advertiser_id` (`string`, required): UUID of the advertiser the campaign belongs to. Get it from vibe_list_advertisers. Example: 8a1c4d2e-6b3f-4a9d-b7e5-2f1c0d9e8a7b.
- `countries` (`array`, required): ISO 3166-1 alpha-3 country codes the campaign targets. Vibe requires the exact set USA, so pass ["USA"].
- `goal` (`string`, required): Campaign goal. One of AWARENESS, INSTALL, TRAFFIC, RETARGETING, SALES, LEADS, or ABM. One of: `AWARENESS`, `INSTALL`, `TRAFFIC`, `RETARGETING`, `SALES`, `LEADS`, `ABM`.
- `name` (`string`, required): Campaign name, required, 10 to 100 characters. Example: Spring CTV Awareness 2026.
- `optimization_goal` (`object`, required): Optimization goal for the campaign, as an object with a type and a target value. The type is one of COST_PER_SESSION, COST_PER_LEAD, COST_PER_CALL, COST_PER_PURCHASE, ROAS, CPM, COST_PER_INSTALL, COST_PER_UNIQUE_HOUSEHOLD, or COST_PER_UNIQUE_COMPANY. The value is the target in USD, at least 1, with at most 2 decimal places. Both are required. Example: {"type": "COST_PER_SESSION", "value": 2.5}.
- `active` (`boolean`, optional): Whether the campaign is active. Defaults to true. A new campaign is created in DRAFT status and does not deliver until it is published. Default: `true`.
- `attribution_window` (`string`, optional): Attribution window for conversions. One of TWELVE_HOURS, ONE_DAY, FORTY_EIGHT_HOURS, SEVENTY_TWO_HOURS, SEVEN_DAYS, or THIRTY_DAYS. If omitted the API applies its own default. One of: `TWELVE_HOURS`, `ONE_DAY`, `FORTY_EIGHT_HOURS`, `SEVENTY_TWO_HOURS`, `SEVEN_DAYS`, `THIRTY_DAYS`.

Example input: `{"advertiser_id":"<advertiser_id>","countries":[],"goal":"AWARENESS","name":"<name>","optimization_goal":{"type":"COST_PER_SESSION","value":2.5}}`

### `vibe_create_strategy`

Create Strategy · Write

Create a strategy under a Vibe campaign with a budget, schedule, optional targeting and optional creatives.
Returns the created strategy (id, campaign_id, name, budget, budget_type, starts_at, ends_at, active, review state, targeting, creative_ids, timestamps).
Use this to add a new strategy; use vibe_duplicate_strategy to copy an existing one, or vibe_update_strategy to change one that already exists.
Requires the campaigns:write OAuth scope and an existing campaign id, for example from vibe_list_campaigns or vibe_create_campaign.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `budget` (`integer`, required): Budget in USD as a whole number, 1 or greater, for example 100. Whether it is a daily or overall cap depends on budget_type.
- `budget_type` (`string`, required): Budget type, either DAILY or GLOBAL. One of: `DAILY`, `GLOBAL`.
- `campaign_id` (`string`, required): UUID of the campaign that will contain the new strategy. Get it from vibe_list_campaigns or vibe_create_campaign.
- `name` (`string`, required): Name of the strategy, 3 to 100 characters, for example Primetime US Households.
- `starts_at` (`string`, required): Start date and time of the strategy as an ISO 8601 date-time, for example 2026-11-01T00:00:00Z.
- `active` (`boolean`, optional): Whether the strategy is active. Vibe's default is true, so leave it out for an active strategy. Default: `true`.
- `creative_ids` (`array`, optional): UUIDs of the creatives to attach to the strategy, for example from vibe_list_creatives.
- `ends_at` (`string`, optional): End date and time of the strategy as an ISO 8601 date-time, for example 2026-12-01T00:00:00Z. Optional; leave it out for no end date.
- `targeting` (`object`, optional): Targeting settings for the strategy as an object; include only the groups you want to set. Location targeting (geo) takes include and exclude lists of location ids for regions, cities, metro codes and zip codes, for example ids returned by vibe_search_geolocations. Inventory takes a type (APPS_AND_CHANNELS or LIVE_SPORTS) plus include and exclude lists of channel ids, for example from vibe_list_channels. The age_ranges list accepts RANGE_18_20, RANGE_21_24, RANGE_25_34, RANGE_35_44, RANGE_45_54, RANGE_55_64 and RANGE_65_MORE; genders accepts MALE and FEMALE; devices accepts TV, TABLET and MOBILE. Interests is a list of interest ids, for example from vibe_list_interest_segments. Audiences are set under an upload entry with include and exclude lists of audience UUIDs, for example from vibe_list_audiences. Dayparting takes a preset (CUSTOM, ANY_TIME_ANY_DAY, PRIMETIME, AFTER_WORK, WORK_HOURS, SLEEPING_TIME, WEEKEND or WORK_DAYS); with CUSTOM, add custom_ranges as start and end pairs in minutes from midnight Monday (0 to 10079). Example: {"geo": {"regions": {"include": ["USA/NY"]}}, "devices": ["TV"], "age_ranges": ["RANGE_25_34"], "dayparting": {"preset": "PRIMETIME"}}.

Example input: `{"budget":1,"budget_type":"DAILY","campaign_id":"<campaign_id>","name":"<name>","starts_at":"<starts_at>"}`

### `vibe_duplicate_campaign`

Duplicate Campaign · Write

Duplicate a Vibe campaign, optionally overriding its name, goal, attribution window, optimization goal, active flag, strategies, or creatives.
Returns only the id of the new campaign; call vibe_get_campaign with it to read the full campaign.
Use this to copy a campaign as a starting point; to create one from scratch, use vibe_create_campaign. Requires the campaigns:write scope.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`string`, required): UUID of the campaign to duplicate. Get it from vibe_list_campaigns or from the id returned when the campaign was created. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b.
- `active` (`boolean`, optional): Whether the duplicated campaign is active. Leave unset to use the API default.
- `attribution_window` (`string`, optional): Attribution window for conversions. One of TWELVE_HOURS, ONE_DAY, FORTY_EIGHT_HOURS, SEVENTY_TWO_HOURS, SEVEN_DAYS, or THIRTY_DAYS. If omitted the API applies its own default. One of: `TWELVE_HOURS`, `ONE_DAY`, `FORTY_EIGHT_HOURS`, `SEVENTY_TWO_HOURS`, `SEVEN_DAYS`, `THIRTY_DAYS`.
- `creatives` (`array`, optional): Optional list of creatives for the duplicated campaign. Each entry has the creative's UUID (id) and a name of 1 to 150 characters. Example: [{"id": "5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b", "name": "Spring 30s spot"}].
- `goal` (`string`, optional): Campaign goal. One of AWARENESS, INSTALL, TRAFFIC, RETARGETING, SALES, LEADS, or ABM. One of: `AWARENESS`, `INSTALL`, `TRAFFIC`, `RETARGETING`, `SALES`, `LEADS`, `ABM`.
- `name` (`string`, optional): Campaign name, 10 to 100 characters. Example: Spring CTV Awareness 2026.
- `optimization_goal` (`object`, optional): New optimization goal for the campaign, as an object with a type and a target value. The type is one of COST_PER_SESSION, COST_PER_LEAD, COST_PER_CALL, COST_PER_PURCHASE, ROAS, CPM, COST_PER_INSTALL, COST_PER_UNIQUE_HOUSEHOLD, or COST_PER_UNIQUE_COMPANY. The value is the target in USD, at least 1, with at most 2 decimal places. If you include this object both fields are required; leave it out to keep the current goal. Example: {"type": "COST_PER_SESSION", "value": 2.5}.
- `strategies` (`array`, optional): Optional overrides for the strategies of the duplicated campaign, as a list of strategy objects. Each entry can carry the UUID of the source campaign's strategy it refers to plus new values for its name (3 to 100 characters), active flag, budget in USD (whole number, at least 1), budget_type (DAILY or GLOBAL), starts_at and ends_at date-times, targeting, and creative_ids. Targeting can set geo, inventory, age_ranges, genders, devices, interests, audiences, and dayparting. Example: [{"id": "5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b", "name": "Spring Primetime", "budget": 500, "budget_type": "GLOBAL", "starts_at": "2026-11-01T00:00:00Z", "ends_at": "2026-11-30T23:59:59Z"}].

Example input: `{"campaign_id":"<campaign_id>"}`

### `vibe_duplicate_strategy`

Duplicate Strategy · Write

Duplicate an existing Vibe strategy, optionally overriding fields on the new copy or placing the copy in a different campaign.
Returns the new strategy (id, campaign_id, name, budget, budget_type, starts_at, ends_at, active, review state, targeting, creative_ids, timestamps).
Use this to clone a strategy as a starting point; use vibe_create_strategy to build one from scratch and vibe_update_strategy to edit one in place.
Requires the campaigns:write OAuth scope and the id of the strategy to copy, from vibe_list_strategies.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `strategy_id` (`string`, required): UUID of the Vibe strategy to duplicate. Get it from vibe_list_strategies, or from the id returned by vibe_create_strategy.
- `active` (`boolean`, optional): Override the active flag on the copy: true or false. Leave it out to use Vibe's default for the copy.
- `budget` (`integer`, optional): Budget in USD as a whole number, 1 or greater, for example 100. Whether it is a daily or overall cap depends on budget_type.
- `budget_type` (`string`, optional): Budget type, either DAILY or GLOBAL. One of: `DAILY`, `GLOBAL`.
- `campaign_id` (`string`, optional): UUID of a different campaign to place the copy in. Leave it out to duplicate within the strategy's current campaign. Get it from vibe_list_campaigns.
- `creative_ids` (`array`, optional): UUIDs of the creatives to attach to the strategy, for example from vibe_list_creatives. Leave it out to use Vibe's default for the copy.
- `ends_at` (`string`, optional): End date and time for the copy as an ISO 8601 date-time, for example 2026-12-01T00:00:00Z. Leave it out to use Vibe's default for the copy.
- `name` (`string`, optional): Name of the strategy, 3 to 100 characters, for example Primetime US Households.
- `starts_at` (`string`, optional): Start date and time of the strategy as an ISO 8601 date-time, for example 2026-11-01T00:00:00Z.
- `targeting` (`object`, optional): Targeting settings for the strategy as an object; include only the groups you want to set. Location targeting (geo) takes include and exclude lists of location ids for regions, cities, metro codes and zip codes, for example ids returned by vibe_search_geolocations. Inventory takes a type (APPS_AND_CHANNELS or LIVE_SPORTS) plus include and exclude lists of channel ids, for example from vibe_list_channels. The age_ranges list accepts RANGE_18_20, RANGE_21_24, RANGE_25_34, RANGE_35_44, RANGE_45_54, RANGE_55_64 and RANGE_65_MORE; genders accepts MALE and FEMALE; devices accepts TV, TABLET and MOBILE. Interests is a list of interest ids, for example from vibe_list_interest_segments. Audiences are set under an upload entry with include and exclude lists of audience UUIDs, for example from vibe_list_audiences. Dayparting takes a preset (CUSTOM, ANY_TIME_ANY_DAY, PRIMETIME, AFTER_WORK, WORK_HOURS, SLEEPING_TIME, WEEKEND or WORK_DAYS); with CUSTOM, add custom_ranges as start and end pairs in minutes from midnight Monday (0 to 10079). Example: {"geo": {"regions": {"include": ["USA/NY"]}}, "devices": ["TV"], "age_ranges": ["RANGE_25_34"], "dayparting": {"preset": "PRIMETIME"}}.

Example input: `{"strategy_id":"<strategy_id>"}`

### `vibe_replace_strategy_creatives`

Replace Strategy Creatives · Write

Replace the full set of creatives attached to a Vibe strategy with the creative ids you provide, in one atomic call.
Returns the strategy's resulting creatives (id, advertiser_id, name, type, asset_url, vast_tag_url, approval_status, approval_details, timestamps) with total, limit and offset.
Use this to swap or reset a strategy's creatives; use vibe_update_strategy to change other strategy fields and vibe_list_strategy_creatives to read the current attachments first. Every creative must belong to the strategy's advertiser or Vibe rejects the request.
Requires the campaigns:write OAuth scope, a strategy id from vibe_list_strategies and creative ids from vibe_list_creatives.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `creative_ids` (`array`, required): Full list of creative UUIDs to attach, up to 5000. Replaces any current attachments, so include every creative you want to keep. Get ids from vibe_list_creatives.
- `strategy_id` (`string`, required): UUID of the Vibe strategy to replace the creatives of. Get it from vibe_list_strategies, or from the id returned by vibe_create_strategy.

Example input: `{"creative_ids":[],"strategy_id":"<strategy_id>"}`

### `vibe_strategy_action`

Strategy Action · Write

Perform a lifecycle action on a Vibe strategy: PAUSE or ACTIVATE its delivery.
Returns the updated strategy (id, campaign_id, name, budget, budget_type, starts_at, ends_at, active, review state, targeting, creative_ids, timestamps).
Use this to toggle delivery for one strategy; publishing the parent campaign does not change a strategy's active state. To edit budget, schedule or targeting use vibe_update_strategy.
Requires the campaigns:write OAuth scope and a strategy id from vibe_list_strategies.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Lifecycle action to perform on the strategy: PAUSE or ACTIVATE. One of: `PAUSE`, `ACTIVATE`.
- `strategy_id` (`string`, required): UUID of the Vibe strategy to pause or activate. Get it from vibe_list_strategies, or from the id returned by vibe_create_strategy.

Example input: `{"action":"PAUSE","strategy_id":"<strategy_id>"}`

### `vibe_update_campaign`

Update Campaign · Write

Update a Vibe campaign's name, goal, attribution window, optimization goal, or active flag; send only the fields to change.
Returns the updated campaign. While the campaign is DRAFT you can change name, goal, attribution_window, and optimization_goal; after it is published only active can change, so create a new campaign for anything else.
Use this to edit settings; for lifecycle transitions (PUBLISH, PAUSE, ACTIVATE) use vibe_campaign_action. Requires the campaigns:write scope.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): UUID of the campaign to update. Get it from vibe_list_campaigns or from the id returned when the campaign was created. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b.
- `active` (`boolean`, optional): Set to true or false to switch the campaign's active flag. This is the only field that can still be changed after the campaign is published. Leave unset to keep the current value.
- `attribution_window` (`string`, optional): New attribution window. One of TWELVE_HOURS, ONE_DAY, FORTY_EIGHT_HOURS, SEVENTY_TWO_HOURS, SEVEN_DAYS, or THIRTY_DAYS. Only changeable while the campaign is DRAFT. Leave unset to keep the current value. One of: `TWELVE_HOURS`, `ONE_DAY`, `FORTY_EIGHT_HOURS`, `SEVENTY_TWO_HOURS`, `SEVEN_DAYS`, `THIRTY_DAYS`.
- `goal` (`string`, optional): Campaign goal. One of AWARENESS, INSTALL, TRAFFIC, RETARGETING, SALES, LEADS, or ABM. Only changeable while the campaign is DRAFT. Leave unset to keep the current goal. One of: `AWARENESS`, `INSTALL`, `TRAFFIC`, `RETARGETING`, `SALES`, `LEADS`, `ABM`.
- `name` (`string`, optional): Campaign name, 10 to 100 characters. Example: Spring CTV Awareness 2026. Only changeable while the campaign is DRAFT. Leave unset to keep the current name.
- `optimization_goal` (`object`, optional): New optimization goal for the campaign, as an object with a type and a target value. The type is one of COST_PER_SESSION, COST_PER_LEAD, COST_PER_CALL, COST_PER_PURCHASE, ROAS, CPM, COST_PER_INSTALL, COST_PER_UNIQUE_HOUSEHOLD, or COST_PER_UNIQUE_COMPANY. The value is the target in USD, at least 1, with at most 2 decimal places. If you include this object both fields are required; leave it out to keep the current goal. Example: {"type": "COST_PER_SESSION", "value": 2.5}.

Example input: `{"campaign_id":"<campaign_id>"}`

### `vibe_update_strategy`

Update Strategy · Write

Update an existing Vibe strategy: rename it or change its budget, schedule, active flag, targeting or attached creatives. Send only the fields you want to change.
Returns the updated strategy (id, campaign_id, name, budget, budget_type, starts_at, ends_at, active, review state, targeting, creative_ids, timestamps).
Use this for field edits; use vibe_strategy_action to PAUSE or ACTIVATE delivery, and vibe_replace_strategy_creatives to swap the full set of attached creatives in one call.
Requires the campaigns:write OAuth scope and a strategy id from vibe_list_strategies.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `strategy_id` (`string`, required): UUID of the Vibe strategy to update. Get it from vibe_list_strategies, or from the id returned by vibe_create_strategy.
- `active` (`boolean`, optional): Set the strategy's active flag: true or false. Leave it out to keep the current value. To toggle delivery you can also use vibe_strategy_action.
- `budget` (`integer`, optional): Budget in USD as a whole number, 1 or greater, for example 100. Whether it is a daily or overall cap depends on budget_type.
- `budget_type` (`string`, optional): Budget type, either DAILY or GLOBAL. One of: `DAILY`, `GLOBAL`.
- `creative_ids` (`array`, optional): UUIDs of the creatives to attach to the strategy, for example from vibe_list_creatives. Leave it out to keep the current creatives. To swap the full set in one call, vibe_replace_strategy_creatives is the dedicated tool.
- `ends_at` (`string`, optional): End date and time of the strategy as an ISO 8601 date-time, for example 2026-12-01T00:00:00Z. Leave it out to keep the current value; this tool cannot clear an existing end date.
- `name` (`string`, optional): Name of the strategy, 3 to 100 characters, for example Primetime US Households.
- `starts_at` (`string`, optional): Start date and time of the strategy as an ISO 8601 date-time, for example 2026-11-01T00:00:00Z. Leave it out to keep the current value.
- `targeting` (`object`, optional): Targeting settings for the strategy as an object; include only the groups you want to set. Location targeting (geo) takes include and exclude lists of location ids for regions, cities, metro codes and zip codes, for example ids returned by vibe_search_geolocations. Inventory takes a type (APPS_AND_CHANNELS or LIVE_SPORTS) plus include and exclude lists of channel ids, for example from vibe_list_channels. The age_ranges list accepts RANGE_18_20, RANGE_21_24, RANGE_25_34, RANGE_35_44, RANGE_45_54, RANGE_55_64 and RANGE_65_MORE; genders accepts MALE and FEMALE; devices accepts TV, TABLET and MOBILE. Interests is a list of interest ids, for example from vibe_list_interest_segments. Audiences are set under an upload entry with include and exclude lists of audience UUIDs, for example from vibe_list_audiences. Dayparting takes a preset (CUSTOM, ANY_TIME_ANY_DAY, PRIMETIME, AFTER_WORK, WORK_HOURS, SLEEPING_TIME, WEEKEND or WORK_DAYS); with CUSTOM, add custom_ranges as start and end pairs in minutes from midnight Monday (0 to 10079). Example: {"geo": {"regions": {"include": ["USA/NY"]}}, "devices": ["TV"], "age_ranges": ["RANGE_25_34"], "dayparting": {"preset": "PRIMETIME"}}. The Vibe reference does not say whether a targeting object you send is merged into or replaces the current one, so send the complete targeting you want. Leave it out to keep the current targeting.

Example input: `{"strategy_id":"<strategy_id>"}`

### `vibe_delete_campaign`

Delete Campaign · Destructive

Delete a Vibe campaign that is still in DRAFT.
Returns no content on success (HTTP 204). Only DRAFT campaigns can be deleted; a campaign that has been published can no longer be deleted, and the API answers 422.
Use this to discard an unpublished campaign; to stop a published campaign delivering, use vibe_campaign_action with PAUSE. Requires the campaigns:write scope.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): UUID of the campaign to delete. Get it from vibe_list_campaigns or from the id returned when the campaign was created. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b.

Example input: `{"campaign_id":"<campaign_id>"}`

### `vibe_delete_creative`

Delete Creative · Destructive

Delete a Vibe creative by id. A creative that is used in a published campaign cannot be deleted; Vibe rejects the request.
Returns no content on success (HTTP 204).
Use this to remove an unused creative; to stop a strategy from using a creative without deleting it, use vibe_replace_strategy_creatives instead.
Requires the creatives:write OAuth scope and a creative id from vibe_list_creatives.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `creative_id` (`string`, required): UUID of the Vibe creative to delete. Get it from vibe_list_creatives, vibe_list_strategy_creatives or vibe_list_campaign_creatives.

Example input: `{"creative_id":"<creative_id>"}`

### `vibe_delete_strategy`

Delete Strategy · Destructive

Delete a Vibe strategy by id. A strategy can only be deleted while its parent campaign is still in DRAFT status; otherwise Vibe rejects the request.
Returns no content on success (HTTP 204).
Use this to remove a strategy from a draft campaign; to stop delivery on a live campaign, use vibe_strategy_action with PAUSE instead.
Requires the campaigns:write OAuth scope and a strategy id from vibe_list_strategies.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `strategy_id` (`string`, required): UUID of the Vibe strategy to delete. Get it from vibe_list_strategies, or from the id returned by vibe_create_strategy.

Example input: `{"strategy_id":"<strategy_id>"}`

### `vibe_publish_campaign`

Publish Campaign · Destructive

Publish a DRAFT Vibe campaign so it starts delivering and spending budget.
Returns the published campaign. Publishing is irreversible: afterwards the campaign can no longer be deleted and only its active flag can be changed, though PAUSE can stop delivery. Invalid state transitions return 422.
Use this to take a draft live; to pause or reactivate a published campaign, use vibe_campaign_action. Requires the campaigns:publish scope, which is separate from campaigns:write.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`string`, required): UUID of the campaign to publish. Get it from vibe_list_campaigns or from the id returned when the campaign was created. Example: 5f2b8e1a-3c4d-4e6f-9a7b-1c2d3e4f5a6b.

Example input: `{"campaign_id":"<campaign_id>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
