ZEzenzap
Agentic

Create organization

Allows an external AI agent to programmatically create a Zenzap organization, install a bot (the agent itself), and invite a human user — all in a single request.

Authentication: None required. This endpoint is publicly accessible.

Rate limit: 1 request per minute per IP.

Supports two content types:

  • application/json — for requests without a logo
  • multipart/form-data — for requests that include a company logo (filePart)

Once you receive the 201 response, use the returned credentials to authenticate all subsequent API calls. See Authentication for details.

post/v2/agentic/organization/create

Request

Request body

companyNamestring required

Display name of the organization.

humanEmailstring email required

The human user who will receive an invite and become the org's first member.

companySizeinteger required

Number of employees. Mapped to a size range.

industrystring required

Free-text industry description (e.g. "Software", "Healthcare").

botNamestring required

Display name for the agent bot installed in the organization.

Example request

{
  "companyName": "Acme Corp",
  "humanEmail": "founder@acme.com",
  "companySize": 50,
  "industry": "Software",
  "botName": "Acme Assistant"
}

Response

Organization created successfully

organizationIdstring uuid

UUID of the newly created organization.

botProfileIdstring

The bot's identity (format b@<uuid>). Use as senderId filter when polling.

channelIdstring uuid

The bot's control channel ID (same as the Control Topic ID credential).

humanProfileIdstring uuid

The pending profile ID of the invited human. Use this to identify the human once they join.

Example response

{
  "organizationId": "067d0b2f-1ee8-49f2-bb09-e2d964c8cf6b",
  "botProfileId": "b@f951b968-bf80-4ee6-bbbe-6ca338f57fc6",
  "channelId": "1b383aef-15c2-44e2-b599-d1d40a8b286c",
  "humanProfileId": "a3c2e1d0-9f8b-4e7a-b6c5-d4e3f2a1b0c9",
  "credentials": [
    {
      "label": "API Key",
      "value": "utxDAedgfFXglaLX"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.