API Keys

API keys are required to authenticate requests to the Yoodli REST API.

Each API key must be included as a bearer token in the Authorization header of your API requests.

Authorization: Bearer YOUR_API_KEY_HERE

Organization User Management API Keys

Use these API keys to manage users within your organization programmatically.

Requirements

• You must be an Organization Administrator or Organization Owner
• Maximum of 3 API keys per Organization

Creating an API Key

1. Sign in to Yoodli and switch to "Admin" view
2. Navigate to "Org settings" page
3. Find the "Access and SSO" section and locate "User Management API"
4. Click "Manage" button
5. Click "Create API key" button
6. Fill in the details:
   • Enter a descriptive Key Name
   • Set expiration date (or select "Never expires")

7. Click "Save"
8. You will see the created API key

Multi Org Management API Keys

Use these API keys to manage Organizations within your Multi Org programmatically.

Requirements

• You must be a Multi Org Administrator
• Maximum of 3 API keys per Multi Org

Creating an API Key

1. Sign in to Yoodli and switch to "Admin" view
2. Navigate to "Org settings" page
3. Click "Manage Multi Org" button at the top right corner
4. Move to "Settings" tab
5. Find the "Access" section and locate "Multi Org Management API"
6. Click "Manage" button
7. Click "Create API key" button
8. Fill in the details:
   • Enter a descriptive Key Name
   • Set expiration date (or select "Never expires")
9. Click "Save"
10. You will see the created API key

Securing Your API Key

After a key is created, the page will display your new API key. Save it immediately in a secure location such as:

• Password manager
• Secret management service
• Encrypted configuration file

⚠️ Yoodli cannot display your API key again after initial creation. If you lose the key, you'll need to create a new one.