Authentication

Bearer Token

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer <your-api-token>

Getting Your Token

Log into your Handled dashboard

Navigate to Settings

Go to Settings > API Tokens

Create Token

Click Create API Token

Copy Token

Copy and store the token securely

The token is only shown once. Make sure to copy it before closing the dialog.

Example Request

curl 'https://api.usehandled.io/api/v1/ipaas/integrated-accounts' \
  -H 'Authorization: Bearer sk_live_abc123...' \
  -H 'Content-Type: application/json'

Security Best Practices

Keep Tokens Secret

Anyone with your token can access your account. Never commit tokens to version control.

Use HTTPS

All requests must use HTTPS. HTTP requests are rejected.

Separate Environments

Create separate tokens for development, staging, and production.

Rotate Regularly

Periodically rotate tokens for enhanced security.

Environment Variables

Store your token in an environment variable:

export HANDLED_API_TOKEN="sk_live_abc123..."

Then use it in your requests:

curl 'https://api.usehandled.io/api/v1/ipaas/integrated-accounts' \
  -H "Authorization: Bearer $HANDLED_API_TOKEN"

API Introduction

Pagination

Overview

Admin API

Bearer Token

Getting Your Token

Example Request

Security Best Practices

Keep Tokens Secret

Use HTTPS

Separate Environments

Rotate Regularly

Environment Variables

​Bearer Token

​Getting Your Token

​Example Request

​Security Best Practices

Keep Tokens Secret

Use HTTPS

Separate Environments

Rotate Regularly

​Environment Variables

Bearer Token

Getting Your Token

Example Request

Security Best Practices

Environment Variables