API settings

Settings › API is where you let other tools work with your Agiled data: AI assistants like ChatGPT and Claude, your own scripts, or a developer's integration. Only owners and admins can create keys and webhooks.

Connect an AI assistantCopy Anchor Link

Copy the MCP server URL and add it to your assistant as a custom connector. See Connect AI assistants.

Create an API keyCopy Anchor Link

An API key is a password that lets another system use Agiled on your behalf.

1. Open Settings › API.
2. Under API Keys, enter a Name that says what the key is for, such as Zapier or Reporting.
3. Choose a Preset: read-only access, or full access if the system needs to create or change records.
4. Select Create key.
5. Copy the key straight away and store it somewhere safe. It is only shown once.

You're done when the key appears in the list and the other system can connect with it.

To stop a system using a key, select Revoke next to it.

Send events to another systemCopy Anchor Link

A webhook tells another system the moment something happens in Agiled, such as a new invoice. Your developer can set this up.

1. Under Webhooks, enter the Target URL your developer gives you and a Description.
2. Choose the Events to send.
3. Select Create subscription and copy the secret it shows.

Deliveries lists recent attempts, so you can see whether each one arrived.

Good to knowCopy Anchor Link

• Use one key per tool. Then you can revoke one without breaking the others.
• Choose read-only unless the tool must create or change records.
• A key was shared by mistake? Revoke it and create a new one.
• The page also shows the API base URL, Docs, and OpenAPI links your developer needs. See Developers.

RelatedCopy Anchor Link

• Connect AI assistants
• API keys for developers
• Webhooks for developers