Create or update a Facebook ad (v2)

http
PUT https://services.leadconnectorhq.com/ad-publishing/facebook/ads-v2

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Body

NameTypeRequiredExampleDescription
idstringNoad_123Ad identifier
locationIdstringYesloc_abc123Account identifier
namestringNoMy Ad CreativeAd name
primaryTextstringNoCheck out our offer!Ad primary text
headlinestringNoGreat DealAd headline text
descriptionstringNoLimited time offerAd description text
imageUrlstringNohttps://example.com/img.jpgAd image URL
mediaTypestringNoAd media type Possible values: 'SINGLE', 'CAROUSEL'
  • media (object[]): Media items (images or videos) attached to the ad creative

    • src (string, required): Media source URL Example: https://example.com/image.jpg

    • thumbnailUrl (string): Thumbnail URL (required when type is video) Example: https://example.com/thumb.jpg

    • selectedPoster (number): Selected poster index (required when type is video) Example: 0

    • type (string, required): Media content type Possible values: 'image', 'video' Example: IMAGE

    • name (string): Media file name Example: ad_image.jpg

    • headline (string): Media headline Example: Great Offer

    • description (string): Media description Example: Click to learn more

    • link (string): Media destination link Example: https://example.com

NameTypeRequiredExampleDescription
multiAdvertiserAdsbooleanNoFalseEnable multi-advertiser ads
campaignIdstringYescamp_123Parent campaign ID
adsetIdstringYesadset_123Parent ad set ID
ctastringNoLEARN_MORECall to action type
conversationFormIdstringNoconv_123Conversation form ID
destinationLinkstringNohttps://example.comDestination link URL
destinationFormIdstringNoform_123Destination form ID

Responses

200 - Response
400 - Bad Request
json
{}
401 - Unauthorized
json
{}
422 - Unprocessable Entity
json
{}

Example

curl -X PUT 'https://services.leadconnectorhq.com/ad-publishing/facebook/ads-v2' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "ad_123",
  "locationId": "loc_abc123",
  "name": "My Ad Creative",
  "primaryText": "Check out our offer!",
  "headline": "Great Deal",
  "description": "Limited time offer",
  "imageUrl": "https://example.com/img.jpg",
  "mediaType": "SINGLE",
  "media": [
    {
      "src": "https://example.com/image.jpg",
      "thumbnailUrl": "https://example.com/thumb.jpg",
      "selectedPoster": 0,
      "type": "IMAGE",
      "name": "ad_image.jpg"
    }
  ],
  "multiAdvertiserAds": false,
  "campaignId": "camp_123",
  "adsetId": "adset_123",
  "cta": "LEARN_MORE",
  "conversationFormId": "conv_123",
  "destinationLink": "https://example.com",
  "destinationFormId": "form_123"
}'

Last updated October 26, 2026

Was this page helpful?