Generate more creatives

← Ad campaigns Endpoint: POST https://makelocalads.com/api/v1/campaigns/{campaign_id}/creatives Permission: campaigns:generate This is the campaign page’s “Generate more”. The new creatives follow the campaign’s existing direction: its recipe or ad types, audience, angles and brief. Only the count is chosen.

Usage notes

creative_count can be 3, 5, 10, 15, 20, 25, or 30. The default is 10.
Each creative costs 2 credits. max_credits refuses the request with 422 before anything is charged if the batch would cost more.
Send an Idempotency-Key so a retry after a network failure never starts and charges for a second batch.

Quick start

curl --request POST \
  --url https://makelocalads.com/api/v1/campaigns/84b92447-425f-4d2a-9ba1-7d67bf802332/creatives \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: campaign-more-551" \
  --data '{ "creative_count": 5 }'

const response = await fetch(
  "https://makelocalads.com/api/v1/campaigns/84b92447-425f-4d2a-9ba1-7d67bf802332/creatives",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.LOCALADS_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": "campaign-more-551",
    },
    body: JSON.stringify({ creative_count: 5 }),
  },
);

const campaign = await response.json();

import os
import requests

response = requests.post(
    "https://makelocalads.com/api/v1/campaigns/84b92447-425f-4d2a-9ba1-7d67bf802332/creatives",
    headers={
        "Authorization": f"Bearer {os.environ['LOCALADS_API_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": "campaign-more-551",
    },
    json={"creative_count": 5},
)

campaign = response.json()

Input fields

integer

How many creatives to add: 3, 5, 10, 15, 20, 25, or 30. Defaults to 10.

integer

Refuse the request with 422 credit_limit_exceeded, before anything is charged, if the batch would cost more than this many credits.

Complete JSON schema

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "creative_count": {
      "type": "integer",
      "enum": [3, 5, 10, 15, 20, 25, 30],
      "default": 10
    },
    "max_credits": { "type": "integer", "minimum": 1 }
  }
}

Response

202 Accepted, with a Location header and the campaign. The new creatives appear in creatives as queued. The response shape is the campaign from Create a campaign. Poll GET /campaigns/{campaign_id} with backoff until status is completed, failed, or canceled. See Polling.

Errors

Status	Code	Meaning
`404`	`campaign_not_found`	The campaign is not available to you
`422`	`insufficient_credits`	Not enough credits for every creative. Nothing was charged
`422`	`credit_limit_exceeded`	The batch would cost more than `max_credits`
`422`	`key_budget_exceeded`	This API key has used its monthly budget

See Errors and retries for the error format.

Get started

Set up

Ad campaigns

Listing images

Photoshoots

ChatGPT ads

UGC videos

Core concepts

Help

Generate more creatives

Usage notes

Quick start

Input fields

Response

Errors

​Usage notes

​Quick start

​Input fields

​Response

​Errors

Usage notes

Quick start

Input fields

Response

Errors