Resources · Zapier integration

FoundationX Zapier integrationAutomate FoundationX with Zapier.

The FoundationX Zapier integration gives you 4 triggers, 11 actions and 6 searches to move sources, conversations and workflow runs in and out of FoundationX. Here is what each one does, what it costs, and where it trips people up.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What the FoundationX Zapier integration actually does

It links your FoundationX account to Zapier so that something happening in FoundationX (a new source, a new conversation, a new workflow run) can start an automation, and so that other steps can write into FoundationX for you: save a file, open a conversation, run a workflow.

Three results people build with it. A source library that files itself: Fetch Sources spots each new source, Link Source to Project attaches it to the right project. Workflow output that leaves FoundationX: List Workflow Runs finds a past run of a workflow, the Get Results search pulls what it produced, and the next step hands it on. Conversations opened from the outside: Create Conversation then Create Message No Stream start a thread and post the first message, without anyone opening the app.

Now the limits, because they shape the whole build. None of the 4 triggers is instant: every one is checked on a timer, so on the free plan you wait up to 15 minutes. There is no find-or-create shortcut either. And the delete side is thin: conversations can go, sources and workflows cannot be removed from a Zap.

If Zapier is not your tool, the same app exists on the other side: see the FoundationX Make integration, and the Make vs Zapier comparison for the criteria that separate the two.

Vocabulary

Zapier words, in plain English

Seven words come back on every line of this page. Here they are once, so the rest reads easily.

Zap
The automation you build in Zapier: one starting event, then one or more steps that run each time that event happens.
Trigger
The event that starts the Zap, like a new source showing up in FoundationX. Once the Zap is on, Zapier waits for it.
Action
What the Zap does after it starts: the step that writes, sends or saves something for you in an app.
Task
What Zapier bills: one action your Zap completes successfully. Your plan counts tasks, and nothing else.
Polling vs instant
Polling means Zapier checks the app on a timer and keeps what is new. Instant means the app calls Zapier itself, the moment it happens.
Filter
A step that lets the Zap carry on only when what arrived meets your condition, and stops it quietly otherwise.
Search step
A step that looks up something already in the app, so the steps after it can use what it found.
Cost

What a FoundationX Zap really costs

FoundationX is not a premium app: it works on the free plan. What you pay for is tasks, and the trigger never counts as one.

  • Free plan100 tasks a month, unlimited Zaps
  • Free plan Zap size2 steps: one trigger, one action
  • Trigger checksFree, however often Zapier looks
  • Premium appNo, FoundationX works on Free

Every action that succeeds is one task, each on its own: a Zap that saves a source, links it and fetches its text burns three per run. An action that fails is not counted, and a few apps or actions take more than one task when they complete. The real wall is elsewhere: the free plan only builds two-step Zaps, one trigger and one action. Add a filter, a search or a second action and you are on a multi-step Zap, which needs a paid plan.

Connect

Connect FoundationX to Zapier in three steps

  1. 01

    Open the Apps page

    In your Zapier account, go to Apps and click + Add connection. A connection is your FoundationX account linked to Zapier once, then reused by every step that touches FoundationX.

  2. 02

    Pick FoundationX

    Type FoundationX in the search box of the dialog, select it, then click Add connection. You need an existing FoundationX account before this point: Zapier does not create one for you.

  3. 03

    Sign in and grant access

    Sign in to FoundationX in the tab that opens and allow Zapier into the account. If the Zap will touch projects or workflows you do not own, check first that your account has read or write rights on them.

First Zap

Your first Zap: an opening message in the right conversations

GoalEach time a new conversation appears in FoundationX, post a standard first message in it, but only in the conversations your filter lets through.

  1. 01

    Build: pick the trigger

    In the editor, choose FoundationX as the app and Fetch Conversations as the event. Select the FoundationX connection you added earlier.

  2. 02

    Test the trigger

    Run the test: Zapier brings back the three most recent conversations of the connected account. Pick a real one, so the mapping in the next steps uses real values.

  3. 03

    Add the filter

    Add a Filter step. Pick one of the fields the test conversation shows, a rule, and the value to compare with. Use a text rule on text, or the filter never lets anything through.

  4. 04

    Add the action

    Add Create Message No Stream. Map the conversation's id brought back by the trigger into Conversation Id, then write your opening message in Message. Both fields are required.

  5. 05

    Test, then Publish

    Test each step and read what came back. Then click Publish to switch the Zap on. The filter makes it a multi-step Zap, so a paid plan.

Triggers

The 4 FoundationX triggers

4 events start a Zap when something happens in FoundationX. Zapier checks for them at the interval your plan allows.

1

Fetch Conversations

Polling trigger

In Zapier“Fetches a list of conversations.”

Starts the Zap when a new conversation shows up in your FoundationX account, so whatever happens next can work from that conversation's details.

How it fires
Zapier goes and looks at regular intervals, and how often depends on your plan: every 15 minutes on the free one.
When to use it
a support lead wants every new conversation logged somewhere the whole team reads, without opening FoundationX all day.
Watch out
a Zap on this trigger that also uses Create Conversation will keep feeding itself, one new conversation after another.
2

Fetch Sources

Polling trigger

In Zapier“Fetches a list of sources.”

Reacts to each new source added to FoundationX and passes it to the next step of your Zap, ready to be filed or read.

How it fires
Zapier goes and looks at regular intervals, and how often depends on your plan: every 15 minutes on the free one.
When to use it
a research team drops material into FoundationX and wants it attached to a project straight after, with Link Source to Project.
Watch out
never pair it with Save Source to Organisation in the same Zap, or every saved source triggers the next run.
3

Fetch Workflows

Polling trigger

In Zapier“Fetches a list of workflows.”

Fires when a new workflow appears in FoundationX. Useful as a starting point when the people building workflows are not the people who run them.

How it fires
Zapier goes and looks at regular intervals, and how often depends on your plan: every 15 minutes on the free one.
When to use it
an operations manager wants a preview generated for each new workflow, through Create Workflow Preview, before anyone runs it for real.
Watch out
the preview step needs source ids too, so the Zap has to know which sources to test against.
4

Fetch Workflow Runs

Polling trigger

In Zapier“Fetches a list of workflow runs.”

Picks up each new run of a FoundationX workflow. It is the trigger to start from when the output of a run matters more than the workflow itself.

How it fires
Zapier goes and looks at regular intervals, and how often depends on your plan: every 15 minutes on the free one.
When to use it
an analyst wants each new run noted in the team's tracker as soon as Zapier picks it up, without checking FoundationX by hand.
Watch out
the trigger reports a run once, when Zapier first sees it, so do not build a filter that waits for that run to change later.
Actions

The 11 FoundationX actions

FoundationX gives you 11 actions. For each one: what it does for you, when to reach for it, and what to watch out for.

1

Save Source to Organisation

Action

In Zapier“Save sources to Organisation.”

Adds a source to your FoundationX organisation from a URL or a block of raw text. Both Name and Type are required: Name holds the data itself, Type tells FoundationX how to process it.

When to use it
a marketer saves every article link the team shares as a source, ready for analysis.
2

Create Conversation

Action

In Zapier“Creates a new conversation.”

Opens a new conversation in FoundationX. The only required field is its Name, so it is a quick step to place in front of a message.

When to use it
each new client file gets its own named conversation, ready for the questions that follow.
3

Create Message No Stream

Action

In Zapier“Creates a new message within a conversation.”

Posts a message inside an existing conversation. It needs the Conversation Id and the Message, so it usually sits right after Create Conversation or a step that returns an id.

When to use it
you want a standard opening question sent the moment a conversation is created.
4

Create Workflow Preview

Action

In Zapier“Creates a preview for a workflow execution.”

Builds a preview of a workflow run on a set of sources. It wants the Workflow Id, the Sources as a comma-separated list of ids like 31479, 31480, and the Project Id on an Organization connection.

When to use it
check a workflow on two sources before running it on everything.
5

Delete Conversation

Action

In Zapier“Soft deletes a conversation by its ID.”

Removes a conversation, found by its Conversation Id. FoundationX describes it as a soft delete. It is the only delete action the integration offers.

When to use it
test conversations created while building a Zap need cleaning up once the Zap works.
6

Get Conversation by ID

Action

In Zapier“Fetches a specific conversation by its ID.”

Fetches one specific conversation from its Conversation Id. It brings that conversation into the Zap so later steps can read it.

When to use it
a step earlier in the Zap gave you an id and you need the full conversation behind it.
Watch out
it sits among the actions, so a successful run counts as a task.
7

Get Message by ID

Action

In Zapier“Fetches a specific message by its ID within a conversation.”

Retrieves a single message, located by two required ids: the Conversation Id and the Message Id. Handy when only one answer matters, not the whole thread.

When to use it
a manager wants one precise reply copied into a report.
8

Get Text From Source

Action

In Zapier“Retrieve text from source.”

Reads the text held in a source and returns it to the Zap. Give it the Source Id and the next step receives the text to work with.

When to use it
the content of a newly saved source has to be sent to another tool as plain text.
10

Run Workflow

Action

In Zapier“Executes a workflow with specified parameters.”

Executes a FoundationX workflow. Workflow Id, Workflow Run Id and Reset Results are required, and Project Id too when the connection type is Organization.

When to use it
a new batch of sources should be processed without anyone pressing the button in FoundationX.
11

Save File to Organisation

Action

In Zapier“Uploads a file to an organisation's resource pool. Supports metadata and callback options.”

Uploads a file into the organisation's resource pool. Three fields are mandatory: the Filename, which must end with its extension such as .pdf, the File itself, and a Metadata field written as JSON text.

When to use it
contracts arriving as attachments land in FoundationX without a manual upload.
Watch out
a filename without its extension blocks the step.
Searches

The 6 FoundationX searches

6 search steps look for data that already exists in FoundationX, so a later step can use it.

A search step does not create anything: it finds what already exists in FoundationX and hands it to the next step. In the editor, these six sit at the bottom of the Action event list, under SEARCH. Three settings decide what happens when the result is not the one you expected.

1

Get Results

Search

In Zapier“Retrieves the results of a specific workflow run.”

Retrieves what a given workflow run produced. It needs the Workflow Id, the Workflow Run Id and an Export By format, for example sources.

When to use it
when you already hold the ids of a finished run, for example from List Workflow Runs, and want what it produced saved or sent.
2

Get All Conversations

Search

In Zapier“Fetches all conversations within the specified date range.”

Pulls every conversation created within a date range you set, rather than a single one. It is the way to look back over a period.

When to use it
a team lead wants the conversations of a given stretch gathered for a review.
3

List Organisation Projects

Search

In Zapier“This endpoint allows users to fetch all projects from the organisation.”

Returns the projects of your FoundationX organisation. It is often the missing link when a later step asks for a Project Id that no earlier step carried.

When to use it
before Run Workflow on an Organization connection, to get the right project.
4

List All Sources

Search

In Zapier“This endpoint allows users to fetch all sources.”

Fetches all the sources held in FoundationX, so a Zap can work on the existing library and not only on what arrives next, one step after the trigger.

When to use it
you need a list of source ids to feed Create Workflow Preview.
5

List All Workflows

Search

In Zapier“Retrieves a list of NER workflows.”

Gives back the list of NER workflows in the account. Use it when the workflow to run is not fixed in advance and has to be picked by the Zap.

When to use it
a Zap has to find the workflow it will hand to Run Workflow.
6

List Workflow Runs

Search

In Zapier“Retrieves a paginated list of execution runs for a specific workflow.”

Lists the runs of one workflow, page by page. The Workflow Id is the only required field, so you can look back on past runs of that one workflow.

When to use it
a run id is needed for Get Results and the trigger did not bring it.

The three settings every search exposes

  1. Successful if no search results are found?
    Left on its default, an empty search stops the Zap there and the steps that needed it are skipped. Switch it on and the Zap carries on with nothing.
  2. Create X if it doesn't exist yet?
    This box turns a search into find-or-create. FoundationX offers no such variant, so you will not see it on these six searches.
  3. If multiple search results are found?
    Three ways out when several items match: keep the first one (the default), stop the Zap, or pass all of them on at once.
When it breaks

When a FoundationX Zap breaks

Zapier attaches no help article of its own to FoundationX, and no app-specific limit is documented. What breaks is the general Zapier behaviour, applied to this app.

Four cases to know before you build. Two of them cost tasks before you notice. If a Zap stops for a reason not listed here, the Zapier troubleshooting guide is the next stop.

  • Old sources are never picked up

    A Zap only reacts to what happens after you publish it. The sources and runs already in FoundationX stay where they are: moving that backlog is a separate job.
  • A Zap that triggers itself

    Fetch Sources plus Save Source to Organisation, or Fetch Conversations plus Create Conversation: each write starts a new run, and the task count melts.
  • A bulk import held back

    After a large import of sources, the trigger suddenly returns a huge batch. Zapier's flood protection can hold it back instead of running everything.
  • No double runs, by design

    On a polling trigger, Zapier remembers what it has already seen. The same source or conversation never starts the Zap twice, even if it changes later.
Need help

Need help automating FoundationX with Zapier?

A person reads every message.

FAQ

FoundationX Zapier integration: your questions

01Is the FoundationX Zapier integration free?
Yes, as far as Zapier is concerned. FoundationX is not a premium app, so it works on the free plan, which gives 100 tasks a month and unlimited Zaps. The catch is the size of a Zap: on Free, a Zap has two steps, one trigger and one action. As soon as you add a filter, a search such as Get Results, or a second action, the Zap becomes multi-step and needs a paid plan. The free plan also checks for new items every 15 minutes, which matters here since every FoundationX trigger works that way.
02How many tasks does a FoundationX Zap use?
One task for every action that completes successfully, and nothing for the trigger. Zapier checking FoundationX for new sources or runs is free, however often it looks. So a Zap with Fetch Sources and Link Source to Project costs one task per new source. Add Get Text From Source after it and you are at two per source. An action that fails is not counted. Keep in mind that Get Conversation by ID and Get Message by ID are listed as actions, so they count too when they work.
03Does FoundationX work in real time with Zapier?
No. All 4 FoundationX triggers are polling triggers: Zapier checks the app on a timer and keeps only what is new. On the free plan that check runs every 15 minutes, on Professional every 2 minutes, and on Team or Enterprise every minute. The type comes from the app itself and cannot be switched in the editor. On paid plans you can also run a check by hand from the editor when you are testing and do not want to wait.
04What does connecting FoundationX to Zapier require?
A FoundationX account, and rights on whatever the Zap will touch. If the Zap writes to projects or workflows that belong to someone else, your account needs read or write access to them first. The connection itself starts from the Apps page of Zapier with + Add connection, then you search FoundationX, sign in to it in the tab that opens and grant access. Once linked, every step that uses FoundationX reuses that same connection.
05Why does Run Workflow ask for a Project Id?
Because your connection type is Organization. FoundationX only requires the Project Id on Run Workflow and Create Workflow Preview when the account is connected at the organisation level. If you do not know the id, place the List Organisation Projects search before the action and map its result into the field. The same two actions also ask for the Workflow Id, and Run Workflow needs a Workflow Run Id and the Reset Results setting, so prepare those values before building the step.
06What if the FoundationX action that is needed does not exist?
Then Zapier cannot do it with this app today. The integration covers 11 actions and 6 searches, and nothing outside that list: there is no way to delete a source or a workflow from a Zap, for example, only a conversation. The usual way around is to chain what exists, such as a search followed by an action. If the step really is missing, it is worth checking whether another automation tool exposes more of FoundationX before forcing a workaround.
07Zapier, Make or n8n for FoundationX?
It depends on your criteria, not on a winner. On Zapier, FoundationX works on the free plan, with 4 polling triggers, 11 actions and 6 searches, and two-step Zaps until you pay. The criteria worth comparing are how each tool bills a run, how many steps you get before paying, and which FoundationX operations each one exposes. Check those three against the Zap you plan to build, then pick the tool that covers it with the fewest workarounds.