pullwireDocs

Zapier

Call any tool with Webhooks by Zapier (Custom Request) and use the results in later steps.

Webhooks by Zapier sends the request. Zapier lists it as a premium app, so it needs a paid Zapier plan.

Before you start

You need an API key (it starts with af_live_). Sign up with your email and you get 2,000 free credits.

1. Add the action

Add an action step, pick Webhooks by Zapier and choose the Custom Request event.

2. Fill in the request

Method: POST. URL:

URL
https://pullwire.dev/api/v1/tools/youtube-transcripts/runs

3. Send the input

Paste the input into Data as raw JSON. Zapier sends it exactly as typed, so keep it valid JSON. Map fields from earlier steps into it.

Data
{
  "videos": [
    "https://www.youtube.com/watch?v=jNQXAC9IVRw"
  ],
  "maxResults": 3
}

4. Add the headers

Under Headers add x-api-key with your key and Content-Type with application/json. Without the content type the request is not read as JSON.

5. Test and use the results

Test the step. The answer shows the run and its results; map them into later steps, or add Looping by Zapier to handle each result on its own.

Answer (SAMPLE)
{
  "run": {
    "id": "…",
    "status": "succeeded",
    "resultsCount": 1,
    "creditsUsed": 1,
    "error": null
  },
  "results": [
    {
      "…": "one object per result, fields depend on the tool"
    }
  ]
}

The values above are a SAMPLE: real answers carry real IDs and all fields of the tool.

6. Bigger jobs

Add ?async=1 to the URL, then Delay by Zapier, then a Webhooks GET step to /api/v1/runs/{run id}/results with the same x-api-key header.

Good to know

  • The call waits up to 25 seconds for the results. For bigger jobs add ?async=1 to the URL: you get a run id back right away and fetch the results a bit later.
  • Errors come back with a code, e.g. INSUFFICIENT_CREDITS (402) or INVALID_INPUT (400).

On this page