List custom tools

Returns every custom HTTP tool defined for your organization.

Scope: custom_tools:read

Query parameters

Example request

curl https://dashboard.getmacha.com/api/v1/custom_tools \
  -H "Authorization: Bearer $MACHA_API_KEY"

Example response

{
  "data": [
    {
      "id": "tool_64f1c0...",
      "name": "custom_list_postmark_templates",
      "label": "List Postmark Templates",
      "description": "Returns the list of email templates from Postmark.",
      "type": "read",
      "method": "GET",
      "url": "https://api.postmarkapp.com/templates",
      "auth": { "type": "api_key", "header_name": "X-Postmark-Server-Token" },
      "parameters": [],
      "group": { "name": "Postmark", "icon": null, "color": null },
      "created_at": "2026-06-01T00:00:00.000Z",
      "updated_at": "2026-06-20T12:00:00.000Z"
    }
  ],
  "meta": { "request_id": "req_...", "next_cursor": null }
}

Errors