Documentation

Organizations API

Manage business accounts and organizations.

Endpoints

POST/organizations

Create a new organization/business account

curl -X POST https://api.insurlink.com/v1/organizations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Insurance Co.",
    "email": "contact@acme.com",
    "phone": "+2348000000000",
    "address": "123 Business Street, Lagos"
  }'

bash

GET/organizations

List all organizations for the current user

curl https://api.insurlink.com/v1/organizations \
  -H "Authorization: Bearer YOUR_API_KEY"

bash

GET/organizations/:accountID

Get details of a specific organization

curl https://api.insurlink.com/v1/organizations/org-123 \
  -H "Authorization: Bearer YOUR_API_KEY"

bash

POST/organizations/:accountID/switch

Switch user context to a specific organization

curl -X POST https://api.insurlink.com/v1/organizations/org-123/switch \
  -H "Authorization: Bearer YOUR_API_KEY"

bash

PUT/organizations/:accountID

Update organization information

curl -X PUT https://api.insurlink.com/v1/organizations/org-123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Business Name",
    "email": "newemail@acme.com"
  }'

bash