Skip to main content
To securely access and interact with Gumloop’s API, authentication is required. Users must generate an API Key, which will be used to authenticate requests. Each workspace has a separate API Key which can be generated under the workspace settings where all of the other workspace credentials are found.
Generating an API key is only available on the Solo plan & above.

​
Generating an API Key

1

Navigate to Credentials

Visit the credentials page to access your workspace credentials page.
2

Generate Your API Key

Generate your unique API Key from the credentials section. This key is essential for making authenticated requests to Gumloop’s API.
Your API Key has been successfully generated! Make sure to store it securely.

​
Using the API Key

With your API Key, you must include it in the headers of every request to the API. The API Key should be sent as an Authorization Bearer token.

​
Authentication Header Format

Authorization: Bearer YOUR_API_KEY_HERE

​
Code Examples

Below are examples of how to include the API Key in requests using different programming languages. 
curl -X POST \
  https://api.gumloop.com/api/v1/start_pipeline \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [INSERT API KEY HERE]" \
  -d '{
    "user_id": "xxxxxxxxxxxxxx",
    "saved_item_id": "xxxxxxxxxxxxxx"
  }'

​
Troubleshooting

If you receive a 401 error:
  1. Verify your API key is correct
  2. Ensure the API key is included in the Authorization header
  3. Check that the header format is: Authorization: Bearer YOUR_API_KEY
  4. Confirm your API key hasn’t been revoked or regenerated
If your API key isn’t working:
  1. Verify you’re on the Solo plan or above
  2. Check that you copied the entire API key without extra spaces
  3. Ensure you’re using the correct workspace’s API key
  4. Try regenerating your API key if issues persist

​
Next Steps

Getting Started

Learn how to make your first API call with Gumloop

Start Automation

Discover how to trigger and run your automations via API

Python SDK

Use our Python SDK for easier integration

JavaScript SDK

Use our JavaScript SDK for easier integration