Skip to main content
POST
/
api
/
v1
/
vendors
/
{vendorId}
/
organizations
Create Organization
curl --request POST \
  --url https://app.phonebot.io:80/api/v1/vendors/{vendorId}/organizations \
  --header 'Content-Type: application/json' \
  --data '
{
  "companyName": "Example Corp",
  "industry": "Technology",
  "contact": {
    "firstName": "Jane",
    "lastName": "Doe",
    "phoneNumber": "+491701234567",
    "country": "DE"
  },
  "planId": "c4a9e3f8-a3b2-4d1c-8b7e-5a9f0d1e2c3b"
}
'
{
  "success": true,
  "timestamp": "2025-04-17T14:23:30Z",
  "message": "<string>",
  "data": null,
  "traceId": "<string>"
}

Path Parameters

​
vendorId
string
required

ID of the Vendor (UUID)

Body

application/json

Data required to create a new Organization.

​
companyName
string
required

Name of the organization.

Example:

"Example Corp"

​
industry
string
required

Industry the organization operates in.

Example:

"Technology"

​
contact
object
required

Primary contact information for the organization.

​
planId
string
required

ID of the Plan assigned to this organization (UUID).

Example:

"c4a9e3f8-a3b2-4d1c-8b7e-5a9f0d1e2c3b"

Response

Organization successfully created

Standard API response wrapper

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
timestamp
string<date-time>
required

Response timestamp in ISO-8601 format

Example:

"2025-04-17T14:23:30Z"

​
message
string

Human-readable message

​
data
any

Payload data object

Example:

null

​
traceId
string

Correlation or trace ID