---
title: "Create a boost"
method: POST
path: "/v1/workspaces/{workspaceId}/boosts"
tags: ["Boost"]
---

# Create a boost

`POST /v1/workspaces/{workspaceId}/boosts`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/boosts`
- Auth: HTTP bearer

Creates and activates a Meta boost for an already published Facebook or Instagram post, once you have approved it. The first request creates nothing. It returns 202 with an approval and the Maeve page where you review it. After you approve there, send the same request again with approvalId. An approval covers one unchanged request and cannot be given by an API key.

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- CreateBoostDto
  - `contentId` string, uuid, required
  - `budgetType` 'daily' | 'lifetime', required
  - `budgetCents` integer, required
  - `currency` string, nullable
  - `startDate` string, required
  - `endDate` string, required
  - `adAccountId` string, nullable
  - `targeting` BoostTargetingDto
    - `countries` string[]
    - `ageMin` integer
    - `ageMax` integer
    - `genders` number[], nullable
  - `approvalId` string, uuid, nullable

## Response `201`

Boost created

- object
  - `data` PublicBoostDto, required
    - `id` string, uuid, required
    - `contentId` string, uuid, required
    - `integrationId` string, uuid, required
    - `adAccountId` string, required
    - `budgetType` 'daily' | 'lifetime', required
    - `budgetCents` number, required
    - `currency` string, required
    - `startDate` string, required
    - `endDate` string, required
    - `targeting` object, required
    - `status` 'creating' | 'created' | 'active' | 'paused' | 'completed' | 'error', required
    - `error` string, nullable, required
    - `impressions` number, required
    - `reach` number, required
    - `spendCents` number, required
    - `clicks` number, required
    - `engagements` number, required
    - `frequency` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
  - `meta` unknown, required

## Other responses

- `202`: Nothing was created. The request is waiting for your approval.

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)