API reference
Apps and the marketplace
The marketplace listings, the apps installed in your company, the developer organization linked to it, and what an installed app calls about its own install.
14 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
Browse the marketplace#
POST/v1/platform/marketplace.listRead
Lists marketplace apps this company can see: apps Bizisy approved, drafts this company may test (private: a developer sandbox's own apps, or the apps of the developer organization linked to this company) and anything installed here, with who owns each (publisher: a person or an organization; verified_company), what each may do (scopes), its events, links and whether it is installed (status, install). Bizisy’s own integrations (Slack, Teams, Google Workspace, Microsoft 365, …) are not apps: platform_marketplace_integrations lists them with their stage (beta or stable). Installing happens in the app (an owner or admin consents).
- Who can call it
- Manage key any Manage role
- MCP tool
platform_marketplace_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
groupstringOnly this group (chat, workspace, tasks, payroll, recruiting, documents, dev, automation, country).
Up to 40 characters.
Returns
An array of objects with 21 fields
An array of objects:
idstringrequiredThe app id.
slugstringrequiredkind"app"requirednamestringrequiredshortstringrequiredlongstringrequiredgroupstring (enum)requiredOne of:
chat,workspace,tasks,payroll,recruiting,documents,dev,automation,country,data,devices,learning,migration.icon_urlstring | nullrequiredscreenshot_urlsstring[]requiredaccentstring | nullrequiredThe app's accent colour (#rrggbb), or null.
developerobjectrequired2 fields
namestringrequiredurlstringrequired
linksobjectrequired5 fields
supportstringrequiredprivacystringrequiredtermsstring | nullrequireddocsstring | nullrequiredpricingstring | nullrequired
scopesstring[]requiredeventsstring[]requiredinstall_urlstringrequiredWhere Install sends the browser (with ?iss=<company address>): the app then asks for consent.
versioninteger | nullrequiredThe approved version listed; null for a draft you can test here.
privatebooleanrequiredA draft you can test here (a developer's sandbox, an organization linked to this company, or your own app as an owner or admin), not reviewed by Bizisy.
draft_via"sandbox" | "organization" | "developer" | "private"requiredWhy this unreviewed draft is offered here: sandbox (a developer's test company), organization (the developer organization linked to this company) or developer (you build it, and only you can install it here as an owner or admin); private: a private app of this company's own developer organization (never reviewed or listed). null for reviewed versions.
publisherobject | nullrequiredWho owns it (a person or an organization); verified_company names the company an organization is linked to.
7 fields
idstringrequirednamestringrequired"By <name>": the organization's name, or the person's display name (never an email).
slugstringrequiredkind"person" | "organization"requiredWho owns the app: one developer (person) or an organization of developers.
logo_urlstring | nullrequiredAn organization's logo; null for none (and for people).
verified_companystring | nullrequiredThe Bizisy company an organization is linked to ("Verified: <company>"); null otherwise.
verified_addressstring | nullrequiredThat company's Bizisy address (<slug>), shown with its name: names are chosen freely, addresses are unique.
status"available" | "installed" | "needs_attention" | "unavailable"requiredavailable, installed, needs_attention (installed, wants more access or not finished), unavailable (suspended or removed: installed here but its tokens are refused).
installobject | nullrequired7 fields
idstringrequiredscopesstring[]requiredeventsstring[]requiredmissing_scopesstring[]requiredWhat the listed version asks for that this install has not consented to.
installed_atstringrequiredactivatedbooleanrequiredThe app finished connecting (exchanged its code).
last_used_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/marketplace.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"group":"payroll"}'const res = await fetch('https://api.bizisy.com/v1/platform/marketplace.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"group": "payroll"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/marketplace.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"group": "payroll",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": [
{
"id": "bza_01k0000000000000000000000a",
"slug": "payroll-sync",
"kind": "app",
"name": "Payroll Sync",
"short": "Sends hires and leavers to your payroll.",
"long": "Keeps your payroll provider in step with Bizisy.",
"group": "payroll",
"icon_url": "https://acme.bizisy.com/api/apps/bza_01k0000000000000000000000a/images/01k0000000000000000000000i",
"screenshot_urls": [],
"accent": null,
"developer": {
"name": "Example Payroll Ltd",
"url": "https://payroll.example.com"
},
"links": {
"support": "mailto:help@payroll.example.com",
"privacy": "https://payroll.example.com/privacy",
"terms": null,
"docs": null,
"pricing": null
},
"scopes": [
"people:view"
],
"events": [
"person.hired"
],
"install_url": "https://payroll.example.com/install",
"version": 1,
"private": false,
"draft_via": null,
"publisher": {
"id": "01k00000000000000000000pub",
"name": "Example Payroll",
"slug": "example-payroll",
"kind": "organization",
"logo_url": null,
"verified_company": "Example Payroll Ltd",
"verified_address": "example-payroll"
},
"status": "installed",
"install": {
"id": "ai1",
"scopes": [
"people:view"
],
"events": [
"person.hired"
],
"missing_scopes": [],
"installed_at": "2026-10-05T11:00:00.000Z",
"activated": true,
"last_used_at": "2026-10-06T09:00:00.000Z"
}
}
]
}Get a marketplace listing#
POST/v1/platform/marketplace.getRead
One marketplace app by slug, as in platform_marketplace_list.
- Who can call it
- Manage key any Manage role
- MCP tool
platform_marketplace_geton HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
slugstringrequired1–60 characters.
Returns
21 fields
idstringrequiredThe app id.
slugstringrequiredkind"app"requirednamestringrequiredshortstringrequiredlongstringrequiredgroupstring (enum)requiredOne of:
chat,workspace,tasks,payroll,recruiting,documents,dev,automation,country,data,devices,learning,migration.icon_urlstring | nullrequiredscreenshot_urlsstring[]requiredaccentstring | nullrequiredThe app's accent colour (#rrggbb), or null.
developerobjectrequired2 fields
namestringrequiredurlstringrequired
linksobjectrequired5 fields
supportstringrequiredprivacystringrequiredtermsstring | nullrequireddocsstring | nullrequiredpricingstring | nullrequired
scopesstring[]requiredeventsstring[]requiredinstall_urlstringrequiredWhere Install sends the browser (with ?iss=<company address>): the app then asks for consent.
versioninteger | nullrequiredThe approved version listed; null for a draft you can test here.
privatebooleanrequiredA draft you can test here (a developer's sandbox, an organization linked to this company, or your own app as an owner or admin), not reviewed by Bizisy.
draft_via"sandbox" | "organization" | "developer" | "private"requiredWhy this unreviewed draft is offered here: sandbox (a developer's test company), organization (the developer organization linked to this company) or developer (you build it, and only you can install it here as an owner or admin); private: a private app of this company's own developer organization (never reviewed or listed). null for reviewed versions.
publisherobject | nullrequiredWho owns it (a person or an organization); verified_company names the company an organization is linked to.
7 fields
idstringrequirednamestringrequired"By <name>": the organization's name, or the person's display name (never an email).
slugstringrequiredkind"person" | "organization"requiredWho owns the app: one developer (person) or an organization of developers.
logo_urlstring | nullrequiredAn organization's logo; null for none (and for people).
verified_companystring | nullrequiredThe Bizisy company an organization is linked to ("Verified: <company>"); null otherwise.
verified_addressstring | nullrequiredThat company's Bizisy address (<slug>), shown with its name: names are chosen freely, addresses are unique.
status"available" | "installed" | "needs_attention" | "unavailable"requiredavailable, installed, needs_attention (installed, wants more access or not finished), unavailable (suspended or removed: installed here but its tokens are refused).
installobject | nullrequired7 fields
idstringrequiredscopesstring[]requiredeventsstring[]requiredmissing_scopesstring[]requiredWhat the listed version asks for that this install has not consented to.
installed_atstringrequiredactivatedbooleanrequiredThe app finished connecting (exchanged its code).
last_used_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/marketplace.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"slug":"payroll-sync"}'const res = await fetch('https://api.bizisy.com/v1/platform/marketplace.get', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"slug": "payroll-sync"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/marketplace.get",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"slug": "payroll-sync",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "bza_01k0000000000000000000000a",
"slug": "payroll-sync",
"kind": "app",
"name": "Payroll Sync",
"short": "Sends hires and leavers to your payroll.",
"long": "Keeps your payroll provider in step with Bizisy.",
"group": "payroll",
"icon_url": "https://acme.bizisy.com/api/apps/bza_01k0000000000000000000000a/images/01k0000000000000000000000i",
"screenshot_urls": [],
"accent": null,
"developer": {
"name": "Example Payroll Ltd",
"url": "https://payroll.example.com"
},
"links": {
"support": "mailto:help@payroll.example.com",
"privacy": "https://payroll.example.com/privacy",
"terms": null,
"docs": null,
"pricing": null
},
"scopes": [
"people:view"
],
"events": [
"person.hired"
],
"install_url": "https://payroll.example.com/install",
"version": 1,
"private": false,
"draft_via": null,
"publisher": {
"id": "01k00000000000000000000pub",
"name": "Example Payroll",
"slug": "example-payroll",
"kind": "organization",
"logo_url": null,
"verified_company": "Example Payroll Ltd",
"verified_address": "example-payroll"
},
"status": "installed",
"install": {
"id": "ai1",
"scopes": [
"people:view"
],
"events": [
"person.hired"
],
"missing_scopes": [],
"installed_at": "2026-10-05T11:00:00.000Z",
"activated": true,
"last_used_at": "2026-10-06T09:00:00.000Z"
}
}
}List app scopes#
POST/v1/platform/marketplace.scopesRead
What a marketplace app may ask for, in plain words: each scope (e.g. people:view), its area and level, and whether it is special (private:read, pay:read: never default, granted only with an explicit tick at install). Every install also reads the company directory as every employee sees it (always_included).
- Who can call it
- Manage key any Manage role
- MCP tool
platform_marketplace_scopeson HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
scopesobject[]required6 fields
idstringrequiredareastringrequiredlevelstringrequiredspecialbooleanrequiredlabelstringrequireddescriptionstringrequired
always_includedstringrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/marketplace.scopes \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/platform/marketplace.scopes', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/marketplace.scopes",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"scopes": [
{
"id": "people:view",
"area": "people",
"level": "view",
"special": false,
"label": "See people and their jobs",
"description": "Profiles, job titles, teams, managers, start dates and job history. Not private details or pay."
}
],
"always_included": "The company directory as every employee sees it: names, job titles, teams and work email."
}
}List installed apps#
POST/v1/platform/app_installs.listRead
The marketplace apps installed in this company: what each may do (scopes), its events, who installed it and when, last use, whether it is a test install of a draft (private), and its state (active, connecting, wants_more, suspended by Bizisy, removed by its developer). Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
platform_app_installs_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
An array of objects with 15 fields
An array of objects:
idstringrequiredapp_idstringrequiredapp_namestringrequiredapp_slugstringrequiredicon_urlstring | nullrequiredscopesstring[]requiredeventsstring[]requiredstate"active" | "connecting" | "wants_more" | "suspended" | "removed" | "unlinked"requiredactive; connecting (consented, the app has not finished); wants_more (a newer version asks for more access); suspended (by Bizisy: its tokens are refused, webhooks paused); removed (deleted by its developer); unlinked (a private app whose organization is no longer linked to this company: its tokens are refused, webhooks wait).
missing_scopesstring[]requiredinstalled_atstringrequiredinstalled_byobjectrequired2 fields
idstringrequirednamestring | nullrequired
last_used_atstring | nullrequiredwebhook_endpoint_idstring | nullrequiredprivatebooleanrequiredA test install of a draft (not reviewed by Bizisy).
draft_via"sandbox" | "organization" | "developer" | "private"requiredFor a draft: installed in a developer sandbox, through the linked developer organization, or by its own developer as an owner or admin of this company (an unreviewed draft); private: a private app of this company's developer organization. null for reviewed versions.
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/app_installs.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/platform/app_installs.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/app_installs.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": [
{
"id": "ai1",
"app_id": "bza_01k0000000000000000000000a",
"app_name": "Payroll Sync",
"app_slug": "payroll-sync",
"icon_url": "https://acme.bizisy.com/api/apps/bza_01k0000000000000000000000a/images/01k0000000000000000000000i",
"scopes": [
"people:view"
],
"events": [
"person.hired"
],
"state": "active",
"missing_scopes": [],
"installed_at": "2026-10-05T11:00:00.000Z",
"installed_by": {
"id": "usr1",
"name": "Ana Ferreira"
},
"last_used_at": "2026-10-06T09:00:00.000Z",
"webhook_endpoint_id": "we2",
"private": false,
"draft_via": null
}
]
}Uninstall an app#
POST/v1/platform/app_installs.uninstallDestructive
Uninstalls a marketplace app from this company at once: its tokens stop working and its webhook endpoint is deleted. Installing it again needs a new consent. Owners and admins. Take install_id from platform_app_installs_list.
- Who can call it
- Manage key owner admin
- MCP tool
platform_app_installs_uninstallon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
install_idstringrequired1–64 characters.
Returns
idstringrequiredapp_namestringrequireduninstalledtruerequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/app_installs.uninstall \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"install_id":"ai1"}'const res = await fetch('https://api.bizisy.com/v1/platform/app_installs.uninstall', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"install_id": "ai1"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/app_installs.uninstall",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"install_id": "ai1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "ai1",
"app_name": "Payroll Sync",
"uninstalled": true
}
}This install#
POST/v1/platform/app_installs.meRead
For a marketplace app, with its install’s access token: the company it is installed in (id, name, address), the scopes it was granted, its webhook endpoint (URL, events, whether you issued its signing secret yet). Call it after the token exchange.
- Who can call it
- MCP tool
platform_app_installs_meon HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
install_idstringrequiredappobjectrequired2 fields
idstringrequirednamestringrequired
companyobjectrequired4 fields
idstringrequirednamestringrequiredslugstringrequiredurlstringrequired
scopesstring[]requiredeventsstring[]requiredwebhookobject | nullrequired5 fields
endpoint_idstringrequiredurlstringrequiredeventsstring[]requiredenabledbooleanrequiredsecret_issuedbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/app_installs.me \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/platform/app_installs.me', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/app_installs.me",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"install_id": "ai1",
"app": {
"id": "bza_01k0000000000000000000000a",
"name": "Payroll Sync"
},
"company": {
"id": "o1",
"name": "Acme Lda",
"slug": "acme",
"url": "https://acme.bizisy.com"
},
"scopes": [
"people:view"
],
"events": [
"person.hired"
],
"webhook": {
"endpoint_id": "we2",
"url": "https://payroll.example.com/hooks",
"events": [
"person.hired"
],
"enabled": true,
"secret_issued": true
}
}
}Issue this install’s webhook signing secret#
POST/v1/platform/app_installs.webhook_secret.issueWrite
For a marketplace app, with its install’s access token: issues the signing secret of the install’s webhook endpoint and returns it once (Standard Webhooks, whsec_…). Call it right after installing; call it again to rotate. For overlap_hours (default 24, 0 to stop the old one at once) the previous secret also signs. Deliveries waiting for retries are signed with the new secret.
- Who can call it
- MCP tool
platform_app_installs_webhook_secret_issueon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
overlap_hoursintegerFrom 0 to 72. Default
24.
Returns
endpoint_idstringrequiredsecretstringrequiredShown once.
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/app_installs.webhook_secret.issue \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"overlap_hours":0}'const res = await fetch('https://api.bizisy.com/v1/platform/app_installs.webhook_secret.issue', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"overlap_hours": 0
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/app_installs.webhook_secret.issue",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"overlap_hours": 0,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"endpoint_id": "we2",
"secret": "whsec_bmV3c2VjcmV0bmV3c2VjcmV0bmV3c2VjcmV0bmU="
}
}List Bizisy’s integrations#
POST/v1/platform/marketplace.integrationsRead
Bizisy’s own integrations this server offers (Slack, Teams, Google Workspace, Jira, …), included with Bizisy: id, name, group, what each does (purpose), how it connects (connect: account, token, account_or_token, address, credentials, cloud or bizisy) and stage. stage beta means it works and Bizisy is still confirming it with real accounts: say "beta" when you suggest one; it can still be set up. Each is set up on its page in Bizisy (link). Marketplace apps by other developers: platform_marketplace_list.
- Who can call it
- Manage key any Manage role
- MCP tool
platform_marketplace_integrationson HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
groupstring (enum)Only this group.
One of:
chat,workspace,tasks,payroll,recruiting,documents,dev,automation,country,data,devices,learning,migration.
Returns
An array of objects with 7 fields
An array of objects:
idstringrequiredThe tool: its page is /manage/integrations/<id> in a company and developers.bizisy.com/apps/<id>.
namestringrequiredgroupstring (enum)requiredOne of:
chat,workspace,tasks,payroll,recruiting,documents,dev,automation,country,data,devices,learning,migration.stage"beta" | "stable"requiredbeta: it works, and Bizisy is still confirming it with real accounts (it can be installed); stable: live and widely used.
purposestringrequiredconnectstring (enum)requiredOne of:
account,token,account_or_token,address,credentials,cloud,bizisy.pathstringrequiredIts page in Bizisy (Manage).
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/marketplace.integrations \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"group":"tasks"}'const res = await fetch('https://api.bizisy.com/v1/platform/marketplace.integrations', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"group": "tasks"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/marketplace.integrations",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"group": "tasks",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": [
{
"id": "jira",
"name": "Jira",
"group": "tasks",
"stage": "beta",
"purpose": "Checklist tasks as Jira issues or service requests, with their status back",
"connect": "account_or_token",
"path": "/manage/integrations/jira"
}
]
}Your company's developer organization#
POST/v1/platform/developer_organization.getRead
The developer organization linked to the company on developers.bizisy.com ("Verified: <company>" on its apps; its drafts can be tested here): its developers (name, email, role), open invitations and apps with their review state; plus organizations you own there that you could link, and ones the company unlinked. Owners and admins.
- Who can call it
- Manage key owner admin
- MCP tool
platform_developer_organization_geton HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
organizationobject | nullrequiredThe developer organization linked to this company ("Verified: <company>"); null when none is.
11 fields
idstringrequirednamestringrequiredslugstringrequiredurlstringrequiredIts public page on developers.bizisy.com.
status"active" | "suspended"requiredmembersobject[]requiredIts developers: names and roles; emails only of those the company invited (or all, in an organization the company created). Never to API keys or AI assistants.
6 fields
developer_idstringrequirednamestringrequiredemailstringrequiredrole"owner" | "developer"requiredyoubooleanrequiredsincestringrequired
invitesobject[]requiredOpen invitations the company sent (all of them in an organization the company created).
5 fields
idstringrequiredemailstringrequiredrole"owner" | "developer"requiredcreated_atstringrequiredexpires_atstringrequired
company_madebooleanrequiredCreated from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.
appsobject[]required3 fields
idstringrequirednamestringrequiredstate"private" | "in_review" | "listed" | "suspended"required
linked_atstring | nullrequiredcreated_atstringrequired
linkableobject[]requiredOrganizations you own on developers.bizisy.com (signed in there with your email) that you could link here.
3 fields
idstringrequirednamestringrequiredslugstringrequired
has_developer_accountbooleanrequiredWhether you have a developer account with your email (needed to link an organization you own).
unlinkedobject[]requiredOrganizations this company unlinked (they no longer show its badge).
3 fields
idstringrequirednamestringrequiredunlinked_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/developer_organization.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/platform/developer_organization.get', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/developer_organization.get",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"organization": {
"id": "01k00000000000000000000pub",
"name": "Example Payroll",
"slug": "example-payroll",
"url": "https://developers.bizisy.com/publishers/example-payroll",
"status": "active",
"members": [
{
"developer_id": "dev1",
"name": "Sam Developer",
"email": "sam@payroll.example.com",
"role": "owner",
"you": false,
"since": "2026-10-01T10:00:00.000Z"
}
],
"invites": [
{
"id": "inv1",
"email": "kim@payroll.example.com",
"role": "developer",
"created_at": "2026-10-02T10:00:00.000Z",
"expires_at": "2026-10-16T10:00:00.000Z"
}
],
"company_made": true,
"apps": [
{
"id": "bza_01k0000000000000000000000a",
"name": "Payroll Sync",
"state": "listed"
}
],
"linked_at": "2026-10-01T10:00:00.000Z",
"created_at": "2026-10-01T10:00:00.000Z"
},
"linkable": [],
"has_developer_account": true,
"unlinked": []
}
}Create a developer organization for your company#
POST/v1/platform/developer_organization.createWrite
Creates a developer organization on developers.bizisy.com linked to this company from the start ("Verified: <company>" on its apps; its drafts can be tested here). You become its owner if you have a developer account with your email; developer_email invites someone else as an owner (they accept in the developer console). One linked organization per company. Owners and admins, in Bizisy only.
- Who can call it
- Manage key owner admin
- MCP tool
platform_developer_organization_createon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
namestringThe organization name shown on listings. Default: the company name.
2–80 characters.
developer_emailanyA developer invited as an owner. Needed when you have no developer account yourself.
Returns
organizationobject | nullrequiredThe developer organization linked to this company ("Verified: <company>"); null when none is.
11 fields
idstringrequirednamestringrequiredslugstringrequiredurlstringrequiredIts public page on developers.bizisy.com.
status"active" | "suspended"requiredmembersobject[]requiredIts developers: names and roles; emails only of those the company invited (or all, in an organization the company created). Never to API keys or AI assistants.
6 fields
developer_idstringrequirednamestringrequiredemailstringrequiredrole"owner" | "developer"requiredyoubooleanrequiredsincestringrequired
invitesobject[]requiredOpen invitations the company sent (all of them in an organization the company created).
5 fields
idstringrequiredemailstringrequiredrole"owner" | "developer"requiredcreated_atstringrequiredexpires_atstringrequired
company_madebooleanrequiredCreated from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.
appsobject[]required3 fields
idstringrequirednamestringrequiredstate"private" | "in_review" | "listed" | "suspended"required
linked_atstring | nullrequiredcreated_atstringrequired
linkableobject[]requiredOrganizations you own on developers.bizisy.com (signed in there with your email) that you could link here.
3 fields
idstringrequirednamestringrequiredslugstringrequired
has_developer_accountbooleanrequiredWhether you have a developer account with your email (needed to link an organization you own).
unlinkedobject[]requiredOrganizations this company unlinked (they no longer show its badge).
3 fields
idstringrequirednamestringrequiredunlinked_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/developer_organization.create \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"name":"Acme Apps","developer_email":"sam@payroll.example.com"}'const res = await fetch('https://api.bizisy.com/v1/platform/developer_organization.create', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"name": "Acme Apps",
"developer_email": "sam@payroll.example.com"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/developer_organization.create",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"name": "Acme Apps",
"developer_email": "sam@payroll.example.com",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"organization": {
"id": "01k00000000000000000000pub",
"name": "Example Payroll",
"slug": "example-payroll",
"url": "https://developers.bizisy.com/publishers/example-payroll",
"status": "active",
"members": [
{
"developer_id": "dev1",
"name": "Sam Developer",
"email": "sam@payroll.example.com",
"role": "owner",
"you": false,
"since": "2026-10-01T10:00:00.000Z"
}
],
"invites": [
{
"id": "inv1",
"email": "kim@payroll.example.com",
"role": "developer",
"created_at": "2026-10-02T10:00:00.000Z",
"expires_at": "2026-10-16T10:00:00.000Z"
}
],
"company_made": true,
"apps": [
{
"id": "bza_01k0000000000000000000000a",
"name": "Payroll Sync",
"state": "listed"
}
],
"linked_at": "2026-10-01T10:00:00.000Z",
"created_at": "2026-10-01T10:00:00.000Z"
},
"linkable": [],
"has_developer_account": true,
"unlinked": []
}
}Link a developer organization to your company#
POST/v1/platform/developer_organization.linkWrite
Links a developer organization you own on developers.bizisy.com (signed in there with your email) to this company: its apps show "Verified: <company>" (with the company's address) and their drafts can be tested here. The organization must not be linked to another company; one linked organization per company. Owners and admins, in Bizisy only. List candidates with platform_developer_organization_get (linkable).
- Who can call it
- Manage key owner admin
- MCP tool
platform_developer_organization_linkon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
organization_idstringrequired1–64 characters.
Returns
organizationobject | nullrequiredThe developer organization linked to this company ("Verified: <company>"); null when none is.
11 fields
idstringrequirednamestringrequiredslugstringrequiredurlstringrequiredIts public page on developers.bizisy.com.
status"active" | "suspended"requiredmembersobject[]requiredIts developers: names and roles; emails only of those the company invited (or all, in an organization the company created). Never to API keys or AI assistants.
6 fields
developer_idstringrequirednamestringrequiredemailstringrequiredrole"owner" | "developer"requiredyoubooleanrequiredsincestringrequired
invitesobject[]requiredOpen invitations the company sent (all of them in an organization the company created).
5 fields
idstringrequiredemailstringrequiredrole"owner" | "developer"requiredcreated_atstringrequiredexpires_atstringrequired
company_madebooleanrequiredCreated from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.
appsobject[]required3 fields
idstringrequirednamestringrequiredstate"private" | "in_review" | "listed" | "suspended"required
linked_atstring | nullrequiredcreated_atstringrequired
linkableobject[]requiredOrganizations you own on developers.bizisy.com (signed in there with your email) that you could link here.
3 fields
idstringrequirednamestringrequiredslugstringrequired
has_developer_accountbooleanrequiredWhether you have a developer account with your email (needed to link an organization you own).
unlinkedobject[]requiredOrganizations this company unlinked (they no longer show its badge).
3 fields
idstringrequirednamestringrequiredunlinked_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/developer_organization.link \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"organization_id":"01k00000000000000000000pub"}'const res = await fetch('https://api.bizisy.com/v1/platform/developer_organization.link', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"organization_id": "01k00000000000000000000pub"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/developer_organization.link",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"organization_id": "01k00000000000000000000pub",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"organization": {
"id": "01k00000000000000000000pub",
"name": "Example Payroll",
"slug": "example-payroll",
"url": "https://developers.bizisy.com/publishers/example-payroll",
"status": "active",
"members": [
{
"developer_id": "dev1",
"name": "Sam Developer",
"email": "sam@payroll.example.com",
"role": "owner",
"you": false,
"since": "2026-10-01T10:00:00.000Z"
}
],
"invites": [
{
"id": "inv1",
"email": "kim@payroll.example.com",
"role": "developer",
"created_at": "2026-10-02T10:00:00.000Z",
"expires_at": "2026-10-16T10:00:00.000Z"
}
],
"company_made": true,
"apps": [
{
"id": "bza_01k0000000000000000000000a",
"name": "Payroll Sync",
"state": "listed"
}
],
"linked_at": "2026-10-01T10:00:00.000Z",
"created_at": "2026-10-01T10:00:00.000Z"
},
"linkable": [],
"has_developer_account": true,
"unlinked": []
}
}Add a developer to your company's developer organization#
POST/v1/platform/developer_organization.members.addWrite
Invites a developer by email to the organization linked to the company, as a developer (builds and submits apps), or as an owner (also manages members and settings in the console) only in an organization the company created. They accept in the developer console. Owners and admins, in Bizisy only.
- Who can call it
- Manage key owner admin
- MCP tool
platform_developer_organization_members_addon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
emailanyrequiredrole"owner" | "developer"Default
"developer".
Returns
idstringrequiredemailstringrequiredrole"owner" | "developer"requiredcreated_atstringrequiredexpires_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/developer_organization.members.add \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"email":"kim@payroll.example.com","role":"owner"}'const res = await fetch('https://api.bizisy.com/v1/platform/developer_organization.members.add', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"email": "kim@payroll.example.com",
"role": "owner"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/developer_organization.members.add",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"email": "kim@payroll.example.com",
"role": "owner",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "inv1",
"email": "kim@payroll.example.com",
"role": "owner",
"created_at": "2026-10-02T10:00:00.000Z",
"expires_at": "2026-10-16T10:00:00.000Z"
}
}Remove a developer from your company's developer organization#
POST/v1/platform/developer_organization.members.removeDestructive
Removes a developer (developer_id) from the organization linked to the company, or cancels an open invitation (invite_id). In an organization the company created, anyone (its last owner included: then add another); in one a developer created and linked, only invitations the company sent and developers who joined through them, never an owner. Owners and admins, in Bizisy only.
- Who can call it
- Manage key owner admin
- MCP tool
platform_developer_organization_members_removeon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
developer_idstringUp to 64 characters.
invite_idstringUp to 64 characters.
Returns
removedtruerequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/developer_organization.members.remove \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"developer_id":"dev1"}'const res = await fetch('https://api.bizisy.com/v1/platform/developer_organization.members.remove', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"developer_id": "dev1"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/developer_organization.members.remove",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"developer_id": "dev1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"removed": true
}
}Unlink your company's developer organization#
POST/v1/platform/developer_organization.unlinkDestructive
Unlinks the developer organization from the company: its apps lose "Verified: <company>" and their drafts can no longer be tested here. The organization, its members and its apps stay as they are (listed apps stay listed). It can be linked again by one of its owners who is an owner or admin here. Needs confirm_name (the organization's name, typed). Owners and admins, in Bizisy only.
- Who can call it
- Manage key owner admin
- MCP tool
platform_developer_organization_unlinkon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
confirm_namestringUp to 100 characters.
Returns
organizationobject | nullrequiredThe developer organization linked to this company ("Verified: <company>"); null when none is.
11 fields
idstringrequirednamestringrequiredslugstringrequiredurlstringrequiredIts public page on developers.bizisy.com.
status"active" | "suspended"requiredmembersobject[]requiredIts developers: names and roles; emails only of those the company invited (or all, in an organization the company created). Never to API keys or AI assistants.
6 fields
developer_idstringrequirednamestringrequiredemailstringrequiredrole"owner" | "developer"requiredyoubooleanrequiredsincestringrequired
invitesobject[]requiredOpen invitations the company sent (all of them in an organization the company created).
5 fields
idstringrequiredemailstringrequiredrole"owner" | "developer"requiredcreated_atstringrequiredexpires_atstringrequired
company_madebooleanrequiredCreated from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.
appsobject[]required3 fields
idstringrequirednamestringrequiredstate"private" | "in_review" | "listed" | "suspended"required
linked_atstring | nullrequiredcreated_atstringrequired
linkableobject[]requiredOrganizations you own on developers.bizisy.com (signed in there with your email) that you could link here.
3 fields
idstringrequirednamestringrequiredslugstringrequired
has_developer_accountbooleanrequiredWhether you have a developer account with your email (needed to link an organization you own).
unlinkedobject[]requiredOrganizations this company unlinked (they no longer show its badge).
3 fields
idstringrequirednamestringrequiredunlinked_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/developer_organization.unlink \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"confirm_name":"Example Payroll"}'const res = await fetch('https://api.bizisy.com/v1/platform/developer_organization.unlink', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"confirm_name": "Example Payroll"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/developer_organization.unlink",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"confirm_name": "Example Payroll",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"organization": null,
"linkable": [
{
"id": "01k00000000000000000000pub",
"name": "Example Payroll",
"slug": "example-payroll"
}
],
"has_developer_account": true,
"unlinked": [
{
"id": "01k00000000000000000000pub",
"name": "Example Payroll",
"unlinked_at": "2026-10-07T10:00:00.000Z"
}
]
}
}Something missing or wrong on this page? Write to hello@bizisy.com.