Plutio Logo
Product
Work AI
TemplatesPricing
Log inTry for free
My account
Sign up
My account
Menu

Product

PricingIntegrationsFeaturesTemplates
new
Changelog
new

Support

Community
On-boarding
Help centre
Contact usStatus

Resources

Stories & SetupsAlternativesComparisonsSolutionsFree toolsMagazine

Company

AboutIn the pressBrand assetsAffiliates

Platforms

API docs
iPhone & iPad
Android
Mac & Windows
Twitter
YouTube
Instagram
Linkedin

All powered by

AI that runs your entire business as if it were you

Proposals drafted, invoices chased, clients updated - ask, and it's done.

Learn more

Close
Log inTry for free
My account
Pricing

Product

Super Work AI

Support

On-boarding
Help centre
Contact usCommunity
Status

Resources

TemplatesAPI docs
AffiliatesStories & SetupsAlternativesComparisonsFree toolsMagazineIntegrations

Company

AboutIn the pressBrand assets

Platforms

iPhone & iPad
Android
Mac & Windows

Connect

Twitter
YouTube
Instagram
Linkedin
Try Plutio free
On this page
  • Covered areas
  • Authentication
  • Base URL and required headers
  • Token request example
  • Rate limits
  • Troubleshooting API requests
  • Common use cases
API and developers
  • API overview
  • API client management
  • Connecting AI tools to Plutio
  • Webhook integration
  • API and third-party connections
  • Common API errors

Help Center / API and developers /

API overview

Plutio's REST API opens your workspace data to external tools, custom integrations, and automated workflows that go beyond what the built-in automation engine handles. Every major area is accessible through documented endpoints.

Covered areas

The API covers projects, tasks, invoices, proposals, contracts, contacts, time entries, wiki pages, conversations, forms, and bookings. Standard operations (create, read, update, delete) are exposed on each area, and endpoint references document the expected request format, response structure, and filtering options for every resource.

Authentication

API access uses OAuth2 with the client_credentials grant type. An API client (created in Settings > API manager) provides a client ID and client secret. A token request to the /oauth/token endpoint returns an access token, which is passed as a bearer token in subsequent API calls. Tokens expire after 72 hours and can be refreshed automatically.

Base URL and required headers

Every Plutio API request goes to https://api.plutio.com and needs both an OAuth bearer token and a workspace header. The token proves which API client is calling. The business header tells Plutio which workspace the request is for.

HeaderValueNotes
AuthorizationBearer ACCESS_TOKENUse the temporary token returned by /oauth/token.
businessYOUR_PLUTIO_SUBDOMAINUse the first part of the Plutio workspace domain. For https://test.plutio.com, send test.

If the business header is missing, Plutio can return {"code":400,"message":"Business undefined is not enabled for this client."}. That response means the token was accepted, but Plutio could not match the request to an enabled workspace.

Token request example

Use the client_credentials grant to create a temporary access token. The client ID and client secret come from API client management. The access token expires after 72 hours, so long-running integrations should request a new token when needed.

POST https://api.plutio.com/v1.11/oauth/token

  • Content-Type: application/x-www-form-urlencoded
  • grant_type=client_credentials
  • client_id=YOUR_CLIENT_ID
  • client_secret=YOUR_CLIENT_SECRET

Rate limits

Rate limits apply per API client to prevent overloading. The current rate limit and remaining allowance are returned in the response headers of each request, so integrations can monitor usage and throttle themselves when approaching the limit.

Troubleshooting API requests

Use the exact status code and error message to decide what to check first. A missing business header, a workspace that is not enabled for the client, an expired token, and a role permission issue all look different.

  • 400 with "Business undefined": add the business header.
  • 400 with "Business X is not enabled": enable that workspace on the API client or send the correct subdomain.
  • 401 unauthorized: generate a fresh token and send it as Authorization: Bearer ACCESS_TOKEN.
  • 403 forbidden: check the role and entity permissions behind the API client.

For the full checklist, see Common API errors.

Common use cases

External systems can push contacts into Plutio's CRM from a marketing platform, pull invoice data into an accounting system, create tasks from an external project management tool, or sync time entries with a payroll service. Because the API covers every major area with full CRUD operations, data can flow in and out of Plutio without manual data entry between systems.

Join 17,000+ businesses

★★★★★

4.6 on Capterra

No credit card required

Need help?

Workspace owners and co-owners can open a conversation with our support team from inside Plutio.

Try Plutio Free

Continue learning

More on API and developers

API client management

API clients are the credentials and webhook settings that external tools use to authenticate with Plutio and receive selected event updates.

Webhook integration

Outbound webhooks send selected Plutio events to external URLs. Use them to trigger Zapier, Make, n8n, or custom services when workspace data changes.

API and third-party connections

Plutio's REST API and webhook system connect workspace data to Zapier, Make, n8n, and custom tools.

Common API errors

Use this guide to diagnose the most common Plutio API authentication, workspace, permission, and webhook configuration errors.

Product

PricingIntegrationsFeaturesTemplates
new
Changelog
new

Support

On-boarding
Help centre
Contact usStatus

Resources

Community
AffiliatesStories & SetupsMagazine

Company

AboutIn the pressBrand assets

Platforms

API docs
iPhone & iPad
Android
Mac & Windows

Products

ContractsDashboardsFilesFormsInboxInvoicingProjectsProposalsSchedulingTasksTimesheets

Compare

vs 17hatsvs Acuityvs Agiledvs AND.COvs Asanavs Basecampvs Bloom.iovs Bonsaivs Calendlyvs ClickUpvs Clockifyvs Copilotvs Dubsadovs Flowluvs FreshBooksvs Harvestvs HoneyBookvs HubSpotvs Indyvs Mondayvs Moxievs Notionvs PandaDocvs Paymovs Pipedrivevs QuickBooksvs Scorovs SuiteDashvs Teamworkvs Togglvs Trellovs Wavevs Wrikevs Xerovs Zoho

Alternatives

17hatsAcuityAgiledAND.COAsanaBasecampBloom.ioBonsaiCalendlyClockifyCopilotDocuSignDubsadoFlowluFreshBooksHarvestHoneyBookHubSpotIndyMondayMoxieNotionPandaDocPaymoPipedriveProposifyQuickBooksScoroSuiteDashTeamworkTogglTrelloWaveWrikeXeroZoho

Solutions

AccountantsAgenciesArchitectsBookkeepersCoachesConsultantsCopywritersDesignersDevelopersEvent PlannersFreelancersInterior DesignersLawyersMarketersMusic ProducersPhotographersPR ProfessionalsReal Estate AgentsSmall BusinessSocial Media ManagersSolopreneursTherapistsVideo ProducersVideographersVirtual AssistantsWedding PlannersWriters

Free Tools

Break-Even CalculatorContract GeneratorDiscount CalculatorDiscount Code GeneratorInvoice GeneratorLate Fee CalculatorNDA GeneratorProfit Margin CalculatorProject Budget CalculatorRate CalculatorSalary to Hourly CalculatorSavings CalculatorTax CalculatorUK Tax Calculator
Twitter
YouTube
Instagram
Linkedin
Facebook
Terms of ServiceFair Usage PolicyPrivacy PolicyCookie PolicyGDPR CommitmentData Processing AgreementSub-processorsNotice at collectionPrivacy choices
Plutio customer review signature
Plutio Logo

One app to run, grow, and automate your business with Super Work AI

Plutio customer review signature