Skip to content
Foreplay logo

Foreplay integration

Competitive advertising data and creative insights platform. Search, filter, and analyze ads and brands with live and historical ad creatives, metadata, and competitive intelligence.

Actions
6
Triggers
3
Auth
API key
License
MIT, open source
Updated
October 2026

About the Foreplay integration

Add the Foreplay piece to a flow, connect your account once, and the rest of the builder can read from it and write to it. Because the piece is open source you can run it on our cloud or self-host it, and combine Foreplay with 770+ other apps in the same flow.

Triggers

Start a flow the moment something happens in Foreplay

Each trigger below can start a flow on its own, either instantly or on a schedule.

  • New Ad in Spyder

    Triggers when Spyder finds a new ad for a tracked brand.

    9 fields

  • New Ad in Board

    Triggers when a new ad shows up in the selected board.

    9 fields

  • New Swipefile Ad

    Triggers when a new ad is saved to your swipe file.

    10 fields

Actions

Everything Activepieces can do in Foreplay

Drop any of these into a flow and fill in the fields. No code is required.

  • Get Ad by ID

    Get detailed information about a specific ad by its public ad library ID. Costs 1 Foreplay credit.

    1 field

  • Get Ads by Page

    Get ads for a Facebook Page ID with filtering and pagination. Costs 1 Foreplay credit per ad returned.

    12 fields

  • Find Brands

    Search for brands by name. Costs 1 Foreplay credit per search.

    2 fields

  • Find Ads

    Search and filter ads by text, dates, platforms, and categories. Costs 1 Foreplay credit per ad returned.

    12 fields

  • Find Boards

    Get the boards of your Foreplay account. Leave Limit empty to get all boards.

    2 fields

  • Custom API Call

    Make a custom API call to a specific endpoint

    10 fields

Use Foreplay in a flow

Connect Foreplay once and every trigger and action above is yours to drop into the builder, alongside 770+ other apps. Free to start, on our cloud or your own servers.

Foreplay, answered.

Yes. Activepieces is open source and free to start, and the Foreplay piece is included on every plan, from the free cloud tier to any self-hosted deployment.

Add the Foreplay piece to a flow, then authenticate with API key. Once connected, its 3 triggers and 6 actions are available anywhere in the builder.

"New Ad in Spyder" can start a flow that runs "Get Ad by ID", and you can chain Foreplay together with any of 770+ other apps and AI steps in between.

Yes. Activepieces is fully self-hostable, so you can run the Foreplay piece on your own infrastructure with your connections and your data staying in your environment.

Yes. Every piece you connect can be exposed over one Activepieces MCP server, so Claude, Cursor, Windsurf or any MCP client can call Foreplay actions as tools.