Adlark

Guide

Use the Adlark API in Make scenarios

Call the Adlark API from Make with the HTTP Make a request module: headers, JSON bodies, file uploads and a sheet-to-ads scenario.

· 5 min read

Make (formerly Integromat) reaches the Adlark API through the built-in HTTP app. One module, Make a request, covers every endpoint. This guide sets it up, then builds a scenario where a marketer types a product into a Google Sheet and gets copy, an image and a UGC script back in the same row.

The Make a request module

Add HTTP -> Make a request and configure it like this for any JSON endpoint:

SettingValue
URLhttps://adlark.alexshipit.com/api/v1/copy (or another endpoint)
MethodPOST (GET for /credits and /jobs/{id})
HeadersName Authorization, value Bearer adl_your_key_here
Body typeRaw
Content typeJSON (application/json)
Request contentYour JSON body
Parse responseYes

Turning on Parse response is the important bit: it makes fields like copy.headlines available to later modules instead of one long text blob. Image calls can take a while, so raise the module timeout (in advanced settings) to the maximum your plan allows.

Keep the key out of shared blueprints. If your Make plan has custom variables, store the full header value there and reference it in the header; otherwise remember to blank it before you export a scenario.

Scenario: from a sheet row to ads

The sheet has columns: Product, Details, Audience, Offer, Status, Headline 1, Headline 2, Primary text, CTA, Image file, Script.

  1. Google Sheets -> Watch New Rows (or Search Rows with a filter Status = new on a schedule).
  2. HTTP -> Make a request: ad copy.
  3. HTTP -> Make a request: one image.
  4. HTTP -> Get a file: download the image with the bearer header.
  5. Google Drive -> Upload a file.
  6. HTTP -> Make a request: UGC script.
  7. Google Sheets -> Update a Row with everything, Status = done.

Module 2: copy

{
  "product": "{{1.Product}}",
  "details": "{{1.Details}}",
  "audience": "{{1.Audience}}",
  "offer": "{{1.Offer}}",
  "platform": "facebook",
  "language": "English"
}

This costs 6 credits at the API rate. If a cell can contain quotes or line breaks, wrap the mapped value with Make's text functions (for example replace) so the raw JSON stays valid, or skip empty optional fields.

Module 3: image

{
  "prompt": "Lifestyle photo of {{1.Product}} in use at home, natural window light, candid, clean background, space for a caption",
  "model": "klein",
  "size": "1K",
  "aspect": "1:1",
  "count": 1
}

9 credits per image. The response contains images[] with url, width and height. Map images[1].url (Make arrays start at 1) into the next module.

Module 4: download

Use HTTP -> Get a file with the image URL and the same Authorization header. The URLs are private to your account, so without the header you get a 401. The output is a file that Google Drive -> Upload a file accepts directly.

Module 6: UGC script

{
  "product": "{{1.Product}}",
  "details": "{{1.Details}}",
  "audience": "{{1.Audience}}",
  "length": 30,
  "angle": "problem then solution"
}

6 credits. Paste the result in the Script column, or send it straight to a creator by email. Tips on what makes these scripts work are in UGC ad scripts.

Uploading files: analysis and captions

For /api/v1/analyze and /api/v1/captions, change Body type to Multipart/form-data and add fields:

  • file: field type File, mapped from a Drive Download a file or HTTP Get a file module.
  • For analysis: optional caption (the ad's text) and platform (Text fields).
  • For captions: style with one of bold-pop, clean, boxed, neon, karaoke, and optional uppercase.

Analysis costs 56 credits and captions 28 credits per video at the API rate. Captions return video.url and srt.url; download both with the bearer header like the images.

Handling errors

  • Right-click the HTTP module -> Add error handler. Use Break with automatic completion for 429 and 503, so Make retries the run later.
  • Treat 402 (not enough credits) separately: route it to an email or Slack module and stop, since retrying cannot succeed.
  • Errors always come back as {"error": "..."}, so map error into your notification text.

Keep costs predictable

This scenario spends about 21 credits per row at the API rate. Add a GET /api/v1/credits module at the start with a filter that stops the run when credits drops below a threshold you pick. Prices for every action are on pricing; the full reference is in the API docs.

Make your next ad today

Pro is $39.99 a month with 3,000 credits. Cancel anytime.