AdMakeAI API for Openclaw

1. Create an AdMakeAI account and configure a brand project in the dashboard. Projects cannot be created through this API.
2. Generate an API key at https://admakeai.com/dashboard/integrations/api.
3. Store the key as an environment variable and never print it, echo it, or write it into a user-visible file.

export ADMAKEAI_API_KEY="amai_live_..."

4. Confirm that curl is available and that the agent has network access.

curl --version
curl -H "x-api-key: $ADMAKEAI_API_KEY" \
  https://admakeai.com/api/v1/user.me

5. Use the REST base URL https://admakeai.com/api/v1 or the MCP endpoint https://admakeai.com/api/mcp. Review typed inputs and examples at https://admakeai.com/api/docs.
6. Connect a Facebook account in the AdMakeAI dashboard before using Facebook account, upload, campaign draft, or Meta reporting tools:

open https://admakeai.com/dashboard/integrations/facebook

7. Configure the Openclaw Skills runtime with the skill metadata requirements: ADMAKEAI_API_KEY and the curl binary. The declared tools are Bash, Read, Write, and WebFetch.

API and transport structure

Core entities

• Project: Brand or product record containing product summary, audience, value proposition, logo, assets, competitors, and research state. Generation tools use projectId.
• AdGeneration: Image creative record with an ID, prompt, status, credit cost, image URL, quality, aspect ratio, and optional source or reference information.
• AdSet: Shared project, brief, ad type, quality, aspect ratio, and a collection of generated variations.
• AdCopy: Copy generation output containing up to five hook, headline, or messaging variations tied to a completed image and project.
• VideoGeneration: Asynchronous UGC or video record with processing status, quality, project scope, and resulting media.
• Inspiration and scraped ads: Competitor research records that can be saved and referenced for creative remixing.
• FacebookConnection: Connected Meta identity containing ad accounts and Pages.
• CampaignDraft and upload records: Reusable creative assets, draft campaigns, ad sets, ads, Meta IDs, and upload states.
• Analytics: Account, campaign, ad set, and ad performance data including spend, impressions, clicks, CTR, CPC, conversions, ROAS, timelines, and comments.

Common metadata

• aspectRatio: 1:1, 4:5, 9:16, or 16:9; useful for feed, Reels, Stories, YouTube, and desktop placements.
• quality: low, high, or ultra, with higher levels consuming more credits.
• adType: product_showcase, promotional, testimonial, lifestyle, comparison, or announcement.
• status: Asynchronous records commonly use PENDING and COMPLETED states.
• Pagination uses { page, perPage }, { limit, cursor }, or { limit, offset } depending on the procedure.

Credit taxonomy

Failed generations are refunded automatically. The API intentionally exposes no delete operations, and Meta pause or resume procedures are disabled and fail closed.