Account
Organization
Create Organization

Create Organization API

Welcome to the documentation for the Create Organization API. This API helps you create an organization.

Base URL

{baseURL}/v1/organizations | POST

Request Payload

FieldTypeSourceRequiredDescription
business_namestringbody✅ YesName of organization
addressstringbody✅ YesOrganization address
emailstringbody✅ YesOrganization email
first_namestringbody✅ YesFirst Name
last_namestringbody✅ YesLast Name
phone_numberstringbody✅ YesOrganization phone number
planstringbody✅ YesPlan available

Sample Request

curl -X POST {baseURL}/v1/organizations \
  -H 'Content-Type: application/json' \
  -d '{
    "business_name": "BOI",
    "address": "lagos_nigeria",
    "email": "[email protected]",
    "first_name": "tunmii",
    "last_name": "wilson",
    "phone_number": "07031833236",
    "plan": "free"
  }'

Sample 200 Response

{
  "message": "Organizations retrieved successfully",
  "data": {
    "items": [],
    "meta": {
      "total": 0,
      "page": 1,
      "limit": 5
    }
  },
  "success": true
}