Skip to main content

Connecting Humaans to Zapier

Updated over 4 months ago

You can automate workflows between Humaans and other tools using Zapier. This guide covers two ways to connect:

  • Method 1: Using Webhooks

  • Method 2: Using the Humaans API (ideal for custom use cases)

Here's a video running through both methods:

Before you Begin

You’ll need:

  • A Zapier Pro Plan.

  • Webhook/API access to Humaans.

  • A clear use case (e.g., trigger when a person is created or updated)

Method 1: Connect via Webhooks

Use this if you want to push data from Humaans into Zapier when something happens (e.g., a person is added or time off is booked).

1. Create a Zap with Webhook Trigger

  1. In Zapier, click Create Zap.

  2. For Trigger, choose Webhooks by Zapier.

  3. Under Trigger Event, select Catch Hook.

  4. Click Continue and copy the generated webhook URL.

2. Set up Webhook in Humaans

  1. In Humaans, go to Settings > Webhooks.

  2. Click Create webhook.

  3. Name your webhook (e.g. Zapier - New Person Trigger) and optionally add a description.

  4. Paste the Webhook URL you copied from Zapier.

  5. Under Events, select the relevant event types (e.g., All profile events).

  6. Click Save.

3. Test and Complete the Zap

  1. Trigger the selected event in Humaans (e.g., add a new person).

  2. In Zapier, click Test Trigger — you should see live data from Humaans.

  3. Proceed to set up an Action b

  4. Publish the Zap when you're ready.

Method 2: Connect via the Humaans API

Use this method when you want to pull data from Humaans or trigger actions more flexibly than the webhook method allows.

Note that the this method wont update information in realtime, but at a specific frequency that you set up within Zapier.

You can refer to our API reference when setting up your Zap.

1. Set up your Zap with a Webhook or Custom Request

  1. In Zapier, Creat a new Zap,

  2. Under Trigger, select Schedule.

  3. For the Trigger event, select the frequency that you will want the Zap to occur.

  4. Under Action, select Custom, then click Webhooks.

2. Configure API Request

  1. Set the request type - GET should suit most use cases in passing Humaans data through Humaans.

  2. Under URL, you can enter the Humaans API endpoint:

https://api.humaans.io/app/people

Under Headers, you'll need to follow a specific format and include your API key. THe box to the left should include Authorization, while the right-hand box should follow the format Bearer (The API access token from Humaans).
​
You can find more details on this within the Authentication section of our API reference.

Authorization: Bearer YOUR_API_KEY

3. Click Test Action to verify the request.

3. Publish the Zap

Once the test returns successfully, complete the rest of your zap logic (e.g., log results, trigger other tools) and publish.

📌 Tips & Best Practices

  • Always test your Zaps first.

  • Use clear naming conventions for webhooks and API keys.

Did this answer your question?