Create a standalone creative

Creates a creative in the library WITHOUT an ad, reusable on the create endpoints via existingCreativeId. Provide exactly one of imageUrl (uploaded server-side), imageHash (from POST /v1/ads/images or the library list), or carouselCards (2-10 hand-built cards). The Page (and linked Instagram account, when present) is resolved from accountId as the story actor.

PlatformsMeta

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Request Body

accountIdstring

Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page.

adAccountIdstring

Meta ad account id (act_).

headlinestring

Lengthlength <= 255

bodystring

Primary text

description?string

Link description below the headline; omitted = Meta scrapes the destination's OG description.

Lengthlength <= 255

callToAction?string

CTA type (same whitelist as POST /v1/ads/create).

Default"LEARN_MORE"

linkUrlstring

Formaturi

imageUrl?string

Publicly reachable image; uploaded to the account's library server-side.

Formaturi

imageHash?string

Existing library image hash (POST /v1/ads/images or GET /v1/ads/images).

carouselCards?

Items2 <= items <= 10

urlTags?string

Appended to every outbound URL (e.g. utm_source=fb).

creativeFeatures?

Advantage+ creative enhancements: partial map of Meta creative feature keys (snake_case) to enroll status, forwarded as degrees_of_freedom_spec.creative_features_spec. Unspecified features default to OPT_OUT.

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adcreatives.createAdCreative({  body: {    accountId: 'account_abc123',    adAccountId: 'adaccount_abc123',    headline: 'string',    body: 'Hello, world!',    linkUrl: 'https://example.com',  },});console.log(data);

{
  "adAccountId": "string",
  "creativeId": "string"
}

Empty

{
  "error": "Unauthorized"
}

Empty

Create a standalone creative

PlatformsMeta

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Request Body

accountIdstring

Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page.

adAccountIdstring

Meta ad account id (act_).

headlinestring

Lengthlength <= 255

bodystring

Primary text

description?string

Link description below the headline; omitted = Meta scrapes the destination's OG description.

Lengthlength <= 255

callToAction?string

CTA type (same whitelist as POST /v1/ads/create).

Default"LEARN_MORE"

linkUrlstring

Formaturi

imageUrl?string

Publicly reachable image; uploaded to the account's library server-side.

Formaturi

imageHash?string

Existing library image hash (POST /v1/ads/images or GET /v1/ads/images).

carouselCards?

Items2 <= items <= 10

urlTags?string

Appended to every outbound URL (e.g. utm_source=fb).

creativeFeatures?

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.adcreatives.createAdCreative({
  body: {
    accountId: 'account_abc123',
    adAccountId: 'adaccount_abc123',
    headline: 'string',
    body: 'Hello, world!',
    linkUrl: 'https://example.com',
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adcreatives.createAdCreative({  body: {    accountId: 'account_abc123',    adAccountId: 'adaccount_abc123',    headline: 'string',    body: 'Hello, world!',    linkUrl: 'https://example.com',  },});console.log(data);

{
  "adAccountId": "string",
  "creativeId": "string"
}

Empty

{
  "error": "Unauthorized"
}

Empty

Create a standalone creative

Authorization

Request Body

Response Body

201application/json

400

401application/json

422

501

Create a standalone creative

Authorization

Request Body

Response Body

201application/json

400

401application/json

422

501

application/json

application/json

application/json

application/json