Custom API allows you to connect to any external API directly from Coldout. Configure your request method, endpoint, headers, body, and query parameters — then map the response fields back into your table.

Select an API (Headers) account to attach authentication headers to your requests, or add a new account by clicking "Add account" in the dropdown and entering a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts from Manage accounts in the account settings.

• Method — the HTTP method for your request. Possible values: GET (retrieve data), POST (create or send new data), PATCH (partially update specific fields), PUT (completely update or replace data), DELETE (delete existing data).
• Endpoint URL — the full API endpoint URL to send the request to (e.g. https://api.example.com/v1/customers). Make sure the endpoint matches the HTTP method and authentication requirements of the API you are connecting to. You can insert dynamic column values using the / shortcut.

• Query parameters — optional key-value pairs appended to the endpoint URL to filter or modify the request (e.g. ?status=active&limit=10). Each parameter requires a key and a value. Commonly used with GET requests. Click + Add new to add parameters.
• Body — the JSON body to send with your request. Use valid JSON formatting — strings in quotes, numbers and booleans without quotes. Typically used with POST, PUT, or PATCH methods. You can insert dynamic column values using the / shortcut.
• Header — define request headers as JSON (e.g. Content-Type: application/json). For sensitive keys like X-API-KEY or Authorization, connect an HTTP API account to securely manage and reuse them across workflows. Click + Add new to add headers.
• Field paths to return — specify which fields to extract from the API response using dot notation (e.g. data.user.profile.linkedin_url). Leave blank to return the full response.
• Request limit — the maximum number of requests allowed within the set time window. The rate limit must average at least 5 requests per second based on the specified limit and duration (default: 5).
• Duration (in ms) — the minimum duration in milliseconds between requests (between 1 and 900,000). Combined with the request limit, it must allow an average of at least 5 requests per second (default: 10000).

Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click Generate, or write your own using column references. The enrichment will only run if the formula resolves to true.

When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.

Clicking Save recipe saves all current input values as a reusable recipe. When saving, you will be prompted to give the recipe a name and an optional description. All saved recipes will be available to select directly from the enrich popup, so you can quickly reapply the same configuration to any table.