Learn how to authenticate your API requests using tokens.

Token-Based Authentication

Humano uses token-based authentication for API access. Each API request must include a valid token in the Authorization header.

1. Generating API Tokens

To get started with the API, you need to generate an API token:

1. Log in to your Humano account
2. Go to Team Settings → API Tokens
3. Click “Generate API Token” (opens the generate form)
4. Give your token a descriptive name
5. Copy the generated token (you won't see it again)

2. Using API Tokens

Include the token in the Authorization header of all API requests:

Header Format

Authorization: Bearer YOUR_API_TOKEN

Example Request

curl -X GET "https://wapify.me/api/team/contacts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

3. Team Context

API requests are automatically scoped to the team that owns the API token. You cannot access data from other teams with the same token.

4. Token Permissions

API tokens inherit the permissions of the user who created them. Make sure the user has appropriate permissions for the operations you need to perform.

5. Error Responses

Common authentication errors:

Invalid Token

{
  "message": "Unauthenticated.",
  "status": 401
}

Missing Token

{
  "message": "Authorization header missing.",
  "status": 401
}

6. Token Management

You can manage your API tokens from the team settings:

• View all your tokens
• Revoke tokens you no longer need
• See when tokens were last used
• Generate new tokens as needed