Overview
The Drum REST API reads and writes data in one Drum account. Webhooks push events from that account to your own HTTPS endpoint, and are managed with this API. To connect AI assistants such as Claude and ChatGPT, see the MCP server docs.
| Base URL | https://app.getdrum.com/api/v1/ |
| Format | JSON in, JSON out |
| Authentication | Authorization: Bearer <api-token> |
| Account | Taken from the token. No account id goes in the URL |
New to the API? Start with the tutorial Make your first API request. For background on how the API is organised, read How the Drum API works.
Reference
| Page | Covers |
|---|---|
| Authentication and permissions | Tokens, the four API permissions, record visibility |
| Requests, errors and limits | Pagination, error bodies, money and dates, idempotency keys, rate limits |
| Accounts and me | GET /accounts and GET /me |
| Projects | List and read delivery projects |
| Tasks | Change a task on a project |
| Opportunities | List, read, create, update and convert opportunities, and edit their deliverables and tasks |
| Tracked times | Read, log, change and delete time entries |
| Costs | Read, create and change project costs |
| Invoices and write-offs | Read invoices and write-offs, allocate a Xero invoice |
| Planned invoices | Read planned invoices |
| Lookup lists | Statuses, lead scores, cost types, finance accounts, members |
| Companies and contacts | Find, create, change and merge companies, manage contacts and link them to records |
| Notes | Notes on companies, contacts, opportunities and projects |
| Proposals | Read a proposal, edit its document, send it, and read signed proposals |
| Proposal budgets | Add, change and remove a proposal’s budget rows |
| Account settings | Account, project and opportunity settings, and proposal numbering |
| Settings catalogs | Custom fields, resource types, cost types, rate cards, project roles, booking types, milestone types |
| Templates | Deliverable and project templates and their rows |
| Proposal templates | Proposal templates, their rate cards, quotes and budgets |