Pluto Profit
The Pluto Profit connection: one store per workspace, read only.
Get the Pluto Profit connection
Whether a Pluto Profit store is connected, how (method: oauth, approved in Pluto Profit, or apiKey), which store (name, Shopify domain, currency, channels), who connected it and when, and how current the store's data is. statusReason says why a reauthorize connection needs reconnecting. A connected store is re-checked at Pluto Profit every few minutes when read. Not for guests.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
checkedAt- When Pluto Profit last confirmed the connection and store.
connectedAt- Connected.
connectedBy- The person who connected it.
connectedByName- The person who connected it, by name.
keyHint- The key's last four characters.
keyKind- The API key's kind (a publishable key reads only).One of
publishable,secret method- How it's connected:
oauth(a person approved access in Pluto Profit) orapiKey(a pasted key).One ofoauth,apiKey oauthAvailable- Connecting by approving in Pluto Profit (connect_pluto_profit) is set up here.
statusreauthorize: Pluto Profit no longer accepts the approval or key (statusReasonsays why); a person reconnects (reconnect_pluto_profit), or an admin pastes a new key in Integrations.One ofconnected,reauthorize,disconnectedstatusReason- Why it needs attention.
store- The connected store; null when disconnected.
store.channels- The store's channels in Pluto Profit.
store.channels[].channelshopify,meta,google, …store.channels[].lastSyncedAt- Its last sync in Pluto Profit.
store.channels[].status- Pluto Profit's status for it (
connected,needs_reauth, …). store.currency- The store's reporting currency (ISO 4217); every Pluto Profit amount is in it.
store.id- Pluto Profit's ID for the store.
store.name- The store's name in Pluto Profit, else its Shopify domain, or "Pluto Profit store".
store.shopDomain- Shopify domain.
syncedThrough- The latest day with synced store data in Pluto Profit.
version- Increments on every change.
curl "$PLUTO_API/integrations/pluto-profit" \
-H "Authorization: Bearer $PLUTO_KEY"Start connecting Pluto Profit
Returns Pluto Profit's approval URL for a person to open in their browser; nothing connects until they approve in Pluto Profit. Give the URL to the person the credential acts for: they must be signed in to Pluto Ads as themselves when they open it. The URL works once, for 15 minutes. reconnect: true approves again for an existing connection (status reauthorize, another store, or moving from an API key). Needs a credential that acts for a person (a connected agent or an mcp agent client; an API key gets 403). 409 when Pluto Profit is already connected (connect) or isn't (reconnect), or when approving in Pluto Profit isn't set up (oauthAvailable: false; connect with an API key instead). The same command as MCP connect_pluto_profit and reconnect_pluto_profit.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
reconnect- Approve again for an existing connection instead of connecting.
returnTo- Where the app opens after the approval, a path such as
/integrations(the default).
Response
authorizationUrl- Pluto Profit's approval for the person to open in their browser (single use).
expiresAt- The URL stops working after this.
personId- The person who must open the URL, signed in to Pluto Ads.
status- The connection's status before the approval.One of
connected,reauthorize,disconnected
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 409Pluto Profit is already connected, isn't connected (reconnect), or approving isn't set up.
- 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/integrations/pluto-profit/authorize" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 999fc24e-70e7-4950-8d18-bbd5a97bfe86" \
-H "Content-Type: application/json" \
-d '{
"reconnect": true,
"returnTo": "/settings/billing"
}'Connect Pluto Profit with an API key
The API-key way to connect. Verifies the key with Pluto Profit, then stores it encrypted and connects its store to the workspace, replacing an earlier store or approval. The key is never returned, logged or kept in receipts; only its last four characters are shown. 422 when Pluto Profit doesn't accept the key.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
apiKey- The store's Pluto Profit API key (
pk_plp_…orsk_plp_…; Pluto Profit, Developers). A publishable key is enough: Pluto Ads only reads.
Response
checkedAt- When Pluto Profit last confirmed the connection and store.
connectedAt- Connected.
connectedBy- The person who connected it.
connectedByName- The person who connected it, by name.
keyHint- The key's last four characters.
keyKind- The API key's kind (a publishable key reads only).One of
publishable,secret method- How it's connected:
oauth(a person approved access in Pluto Profit) orapiKey(a pasted key).One ofoauth,apiKey oauthAvailable- Connecting by approving in Pluto Profit (connect_pluto_profit) is set up here.
statusreauthorize: Pluto Profit no longer accepts the approval or key (statusReasonsays why); a person reconnects (reconnect_pluto_profit), or an admin pastes a new key in Integrations.One ofconnected,reauthorize,disconnectedstatusReason- Why it needs attention.
store- The connected store; null when disconnected.
store.channels- The store's channels in Pluto Profit.
store.channels[].channelshopify,meta,google, …store.channels[].lastSyncedAt- Its last sync in Pluto Profit.
store.channels[].status- Pluto Profit's status for it (
connected,needs_reauth, …). store.currency- The store's reporting currency (ISO 4217); every Pluto Profit amount is in it.
store.id- Pluto Profit's ID for the store.
store.name- The store's name in Pluto Profit, else its Shopify domain, or "Pluto Profit store".
store.shopDomain- Shopify domain.
syncedThrough- The latest day with synced store data in Pluto Profit.
version- Increments on every change.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/integrations/pluto-profit/connect" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 74e3adb7-901b-4015-92c9-e1d029af8346" \
-H "Content-Type: application/json" \
-d '{
"apiKey": "sk_EBOPMPuUHAnWrzaAHMeyUXjfYddSmE21"
}'Disconnect Pluto Profit
Revokes the approval's tokens at Pluto Profit when it can, then deletes the stored approval tokens or key and cached figures. The approval stays listed in Pluto Profit (Settings, Connected apps) until removed there; a key keeps working until revoked there (Developers).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
checkedAt- When Pluto Profit last confirmed the connection and store.
connectedAt- Connected.
connectedBy- The person who connected it.
connectedByName- The person who connected it, by name.
keyHint- The key's last four characters.
keyKind- The API key's kind (a publishable key reads only).One of
publishable,secret method- How it's connected:
oauth(a person approved access in Pluto Profit) orapiKey(a pasted key).One ofoauth,apiKey oauthAvailable- Connecting by approving in Pluto Profit (connect_pluto_profit) is set up here.
statusreauthorize: Pluto Profit no longer accepts the approval or key (statusReasonsays why); a person reconnects (reconnect_pluto_profit), or an admin pastes a new key in Integrations.One ofconnected,reauthorize,disconnectedstatusReason- Why it needs attention.
store- The connected store; null when disconnected.
store.channels- The store's channels in Pluto Profit.
store.channels[].channelshopify,meta,google, …store.channels[].lastSyncedAt- Its last sync in Pluto Profit.
store.channels[].status- Pluto Profit's status for it (
connected,needs_reauth, …). store.currency- The store's reporting currency (ISO 4217); every Pluto Profit amount is in it.
store.id- Pluto Profit's ID for the store.
store.name- The store's name in Pluto Profit, else its Shopify domain, or "Pluto Profit store".
store.shopDomain- Shopify domain.
syncedThrough- The latest day with synced store data in Pluto Profit.
version- Increments on every change.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/integrations/pluto-profit/disconnect" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 6fa66dff-e2f4-431d-9555-ac4a57f3110c"Check a Pluto Profit key
Asks Pluto Profit which store the key belongs to, without storing anything: a key belongs to exactly one store, so choosing the store is choosing its key. alsoConnectedTo names other workspaces of the organization already connected to it. 422 when Pluto Profit doesn't accept the key.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
apiKey- The store's Pluto Profit API key (
pk_plp_…orsk_plp_…; Pluto Profit, Developers). A publishable key is enough: Pluto Ads only reads.
Response
alsoConnectedTo- Other workspaces of the organization already connected to this store.
keyHint- The key's last four characters.
keyKind- The key's kind.One of
publishable,secret storestore.channels- The store's channels in Pluto Profit.
store.channels[].channelshopify,meta,google, …store.channels[].lastSyncedAt- Its last sync in Pluto Profit.
store.channels[].status- Pluto Profit's status for it (
connected,needs_reauth, …). store.currency- The store's reporting currency (ISO 4217); every Pluto Profit amount is in it.
store.id- Pluto Profit's ID for the store.
store.name- The store's name in Pluto Profit, else its Shopify domain, or "Pluto Profit store".
store.shopDomain- Shopify domain.
syncedThrough- The latest day with synced store data.
curl -X POST "$PLUTO_API/integrations/pluto-profit/verify" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Content-Type: application/json" \
-d '{
"apiKey": "sk_EBOPMPuUHAnWrzaAHMeyUXjfYddSmE21"
}'