Skip to content

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_list on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • groupstring

    Only 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:

  • idstringrequired

    The app id.

  • slugstringrequired
  • kind"app"required
  • namestringrequired
  • shortstringrequired
  • longstringrequired
  • groupstring (enum)required

    One of: chat, workspace, tasks, payroll, recruiting, documents, dev, automation, country, data, devices, learning, migration.

  • icon_urlstring | nullrequired
  • screenshot_urlsstring[]required
  • accentstring | nullrequired

    The app's accent colour (#rrggbb), or null.

  • developerobjectrequired
    2 fields
    • namestringrequired
    • urlstringrequired
  • linksobjectrequired
    5 fields
    • supportstringrequired
    • privacystringrequired
    • termsstring | nullrequired
    • docsstring | nullrequired
    • pricingstring | nullrequired
  • scopesstring[]required
  • eventsstring[]required
  • install_urlstringrequired

    Where Install sends the browser (with ?iss=<company address>): the app then asks for consent.

  • versioninteger | nullrequired

    The approved version listed; null for a draft you can test here.

  • privatebooleanrequired

    A 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"required

    Why 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 | nullrequired

    Who owns it (a person or an organization); verified_company names the company an organization is linked to.

    7 fields
    • idstringrequired
    • namestringrequired

      "By <name>": the organization's name, or the person's display name (never an email).

    • slugstringrequired
    • kind"person" | "organization"required

      Who owns the app: one developer (person) or an organization of developers.

    • logo_urlstring | nullrequired

      An organization's logo; null for none (and for people).

    • verified_companystring | nullrequired

      The Bizisy company an organization is linked to ("Verified: <company>"); null otherwise.

    • verified_addressstring | nullrequired

      That company's Bizisy address (<slug>), shown with its name: names are chosen freely, addresses are unique.

  • status"available" | "installed" | "needs_attention" | "unavailable"required

    available, installed, needs_attention (installed, wants more access or not finished), unavailable (suspended or removed: installed here but its tokens are refused).

  • installobject | nullrequired
    7 fields
    • idstringrequired
    • scopesstring[]required
    • eventsstring[]required
    • missing_scopesstring[]required

      What the listed version asks for that this install has not consented to.

    • installed_atstringrequired
    • activatedbooleanrequired

      The app finished connecting (exchanged its code).

    • last_used_atstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/marketplace.list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"payroll"}'
Response
{
  "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_get on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • slugstringrequired

    1–60 characters.

Returns

21 fields
  • idstringrequired

    The app id.

  • slugstringrequired
  • kind"app"required
  • namestringrequired
  • shortstringrequired
  • longstringrequired
  • groupstring (enum)required

    One of: chat, workspace, tasks, payroll, recruiting, documents, dev, automation, country, data, devices, learning, migration.

  • icon_urlstring | nullrequired
  • screenshot_urlsstring[]required
  • accentstring | nullrequired

    The app's accent colour (#rrggbb), or null.

  • developerobjectrequired
    2 fields
    • namestringrequired
    • urlstringrequired
  • linksobjectrequired
    5 fields
    • supportstringrequired
    • privacystringrequired
    • termsstring | nullrequired
    • docsstring | nullrequired
    • pricingstring | nullrequired
  • scopesstring[]required
  • eventsstring[]required
  • install_urlstringrequired

    Where Install sends the browser (with ?iss=<company address>): the app then asks for consent.

  • versioninteger | nullrequired

    The approved version listed; null for a draft you can test here.

  • privatebooleanrequired

    A 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"required

    Why 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 | nullrequired

    Who owns it (a person or an organization); verified_company names the company an organization is linked to.

    7 fields
    • idstringrequired
    • namestringrequired

      "By <name>": the organization's name, or the person's display name (never an email).

    • slugstringrequired
    • kind"person" | "organization"required

      Who owns the app: one developer (person) or an organization of developers.

    • logo_urlstring | nullrequired

      An organization's logo; null for none (and for people).

    • verified_companystring | nullrequired

      The Bizisy company an organization is linked to ("Verified: <company>"); null otherwise.

    • verified_addressstring | nullrequired

      That company's Bizisy address (<slug>), shown with its name: names are chosen freely, addresses are unique.

  • status"available" | "installed" | "needs_attention" | "unavailable"required

    available, installed, needs_attention (installed, wants more access or not finished), unavailable (suspended or removed: installed here but its tokens are refused).

  • installobject | nullrequired
    7 fields
    • idstringrequired
    • scopesstring[]required
    • eventsstring[]required
    • missing_scopesstring[]required

      What the listed version asks for that this install has not consented to.

    • installed_atstringrequired
    • activatedbooleanrequired

      The app finished connecting (exchanged its code).

    • last_used_atstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/marketplace.get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"payroll-sync"}'
Response
{
  "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_scopes on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • scopesobject[]required
    6 fields
    • idstringrequired
    • areastringrequired
    • levelstringrequired
    • specialbooleanrequired
    • labelstringrequired
    • descriptionstringrequired
  • always_includedstringrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/marketplace.scopes \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_list on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

An array of objects with 15 fields

An array of objects:

  • idstringrequired
  • app_idstringrequired
  • app_namestringrequired
  • app_slugstringrequired
  • icon_urlstring | nullrequired
  • scopesstring[]required
  • eventsstring[]required
  • state"active" | "connecting" | "wants_more" | "suspended" | "removed" | "unlinked"required

    active; 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[]required
  • installed_atstringrequired
  • installed_byobjectrequired
    2 fields
    • idstringrequired
    • namestring | nullrequired
  • last_used_atstring | nullrequired
  • webhook_endpoint_idstring | nullrequired
  • privatebooleanrequired

    A test install of a draft (not reviewed by Bizisy).

  • draft_via"sandbox" | "organization" | "developer" | "private"required

    For 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
curl https://api.bizisy.com/v1/platform/app_installs.list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_uninstall on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • install_idstringrequired

    1–64 characters.

Returns

  • idstringrequired
  • app_namestringrequired
  • uninstalledtruerequired

Errors

validation_failed unauthenticated forbidden not_found conflict rate_limited internal

curl
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"}'
Response
{
  "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_me on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • install_idstringrequired
  • appobjectrequired
    2 fields
    • idstringrequired
    • namestringrequired
  • companyobjectrequired
    4 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
    • urlstringrequired
  • scopesstring[]required
  • eventsstring[]required
  • webhookobject | nullrequired
    5 fields
    • endpoint_idstringrequired
    • urlstringrequired
    • eventsstring[]required
    • enabledbooleanrequired
    • secret_issuedbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/app_installs.me \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_issue on HR Assistant
Preview
?dry_run=true runs 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_hoursinteger

    From 0 to 72. Default 24.

Returns

  • endpoint_idstringrequired
  • secretstringrequired

    Shown once.

Errors

validation_failed unauthenticated forbidden not_found conflict rate_limited internal

curl
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}'
Response
{
  "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_integrations on HR Assistant
Method
POST with a JSON body, or GET with 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:

  • idstringrequired

    The tool: its page is /manage/integrations/<id> in a company and developers.bizisy.com/apps/<id>.

  • namestringrequired
  • groupstring (enum)required

    One of: chat, workspace, tasks, payroll, recruiting, documents, dev, automation, country, data, devices, learning, migration.

  • stage"beta" | "stable"required

    beta: it works, and Bizisy is still confirming it with real accounts (it can be installed); stable: live and widely used.

  • purposestringrequired
  • connectstring (enum)required

    One of: account, token, account_or_token, address, credentials, cloud, bizisy.

  • pathstringrequired

    Its page in Bizisy (Manage).

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/marketplace.integrations \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"tasks"}'
Response
{
  "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_get on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • organizationobject | nullrequired

    The developer organization linked to this company ("Verified: <company>"); null when none is.

    11 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
    • urlstringrequired

      Its public page on developers.bizisy.com.

    • status"active" | "suspended"required
    • membersobject[]required

      Its 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_idstringrequired
      • namestringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • youbooleanrequired
      • sincestringrequired
    • invitesobject[]required

      Open invitations the company sent (all of them in an organization the company created).

      5 fields
      • idstringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • created_atstringrequired
      • expires_atstringrequired
    • company_madebooleanrequired

      Created from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.

    • appsobject[]required
      3 fields
      • idstringrequired
      • namestringrequired
      • state"private" | "in_review" | "listed" | "suspended"required
    • linked_atstring | nullrequired
    • created_atstringrequired
  • linkableobject[]required

    Organizations you own on developers.bizisy.com (signed in there with your email) that you could link here.

    3 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
  • has_developer_accountbooleanrequired

    Whether you have a developer account with your email (needed to link an organization you own).

  • unlinkedobject[]required

    Organizations this company unlinked (they no longer show its badge).

    3 fields
    • idstringrequired
    • namestringrequired
    • unlinked_atstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/developer_organization.get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_create on HR Assistant
Preview
?dry_run=true runs 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

  • namestring

    The organization name shown on listings. Default: the company name.

    2–80 characters.

  • developer_emailany

    A developer invited as an owner. Needed when you have no developer account yourself.

Returns

  • organizationobject | nullrequired

    The developer organization linked to this company ("Verified: <company>"); null when none is.

    11 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
    • urlstringrequired

      Its public page on developers.bizisy.com.

    • status"active" | "suspended"required
    • membersobject[]required

      Its 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_idstringrequired
      • namestringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • youbooleanrequired
      • sincestringrequired
    • invitesobject[]required

      Open invitations the company sent (all of them in an organization the company created).

      5 fields
      • idstringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • created_atstringrequired
      • expires_atstringrequired
    • company_madebooleanrequired

      Created from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.

    • appsobject[]required
      3 fields
      • idstringrequired
      • namestringrequired
      • state"private" | "in_review" | "listed" | "suspended"required
    • linked_atstring | nullrequired
    • created_atstringrequired
  • linkableobject[]required

    Organizations you own on developers.bizisy.com (signed in there with your email) that you could link here.

    3 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
  • has_developer_accountbooleanrequired

    Whether you have a developer account with your email (needed to link an organization you own).

  • unlinkedobject[]required

    Organizations this company unlinked (they no longer show its badge).

    3 fields
    • idstringrequired
    • namestringrequired
    • unlinked_atstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found conflict rate_limited internal

curl
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"}'
Response
{
  "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": []
  }
}

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_link on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • organization_idstringrequired

    1–64 characters.

Returns

  • organizationobject | nullrequired

    The developer organization linked to this company ("Verified: <company>"); null when none is.

    11 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
    • urlstringrequired

      Its public page on developers.bizisy.com.

    • status"active" | "suspended"required
    • membersobject[]required

      Its 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_idstringrequired
      • namestringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • youbooleanrequired
      • sincestringrequired
    • invitesobject[]required

      Open invitations the company sent (all of them in an organization the company created).

      5 fields
      • idstringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • created_atstringrequired
      • expires_atstringrequired
    • company_madebooleanrequired

      Created from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.

    • appsobject[]required
      3 fields
      • idstringrequired
      • namestringrequired
      • state"private" | "in_review" | "listed" | "suspended"required
    • linked_atstring | nullrequired
    • created_atstringrequired
  • linkableobject[]required

    Organizations you own on developers.bizisy.com (signed in there with your email) that you could link here.

    3 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
  • has_developer_accountbooleanrequired

    Whether you have a developer account with your email (needed to link an organization you own).

  • unlinkedobject[]required

    Organizations this company unlinked (they no longer show its badge).

    3 fields
    • idstringrequired
    • namestringrequired
    • unlinked_atstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found conflict rate_limited internal

Response
{
  "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_add on HR Assistant
Preview
?dry_run=true runs 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

  • emailanyrequired
  • role"owner" | "developer"

    Default "developer".

Returns

  • idstringrequired
  • emailstringrequired
  • role"owner" | "developer"required
  • created_atstringrequired
  • expires_atstringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict rate_limited internal

curl
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"}'
Response
{
  "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_remove on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • developer_idstring

    Up to 64 characters.

  • invite_idstring

    Up to 64 characters.

Returns

  • removedtruerequired

Errors

validation_failed unauthenticated forbidden not_found conflict rate_limited internal

curl
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"}'
Response
{
  "data": {
    "removed": true
  }
}

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_unlink on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • confirm_namestring

    Up to 100 characters.

Returns

  • organizationobject | nullrequired

    The developer organization linked to this company ("Verified: <company>"); null when none is.

    11 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
    • urlstringrequired

      Its public page on developers.bizisy.com.

    • status"active" | "suspended"required
    • membersobject[]required

      Its 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_idstringrequired
      • namestringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • youbooleanrequired
      • sincestringrequired
    • invitesobject[]required

      Open invitations the company sent (all of them in an organization the company created).

      5 fields
      • idstringrequired
      • emailstringrequired
      • role"owner" | "developer"required
      • created_atstringrequired
      • expires_atstringrequired
    • company_madebooleanrequired

      Created from Bizisy by this company: it may remove any member. Otherwise only those it invited, never an owner.

    • appsobject[]required
      3 fields
      • idstringrequired
      • namestringrequired
      • state"private" | "in_review" | "listed" | "suspended"required
    • linked_atstring | nullrequired
    • created_atstringrequired
  • linkableobject[]required

    Organizations you own on developers.bizisy.com (signed in there with your email) that you could link here.

    3 fields
    • idstringrequired
    • namestringrequired
    • slugstringrequired
  • has_developer_accountbooleanrequired

    Whether you have a developer account with your email (needed to link an organization you own).

  • unlinkedobject[]required

    Organizations this company unlinked (they no longer show its badge).

    3 fields
    • idstringrequired
    • namestringrequired
    • unlinked_atstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found conflict rate_limited internal

Response
{
  "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.

Developer docs