Register new organization

POST

/organizations/register

Register a new organization. This endpoint is used after Firebase authentication
to complete organization setup. The Firebase UID and email are automatically
extracted from the JWT token.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.perfectworks.io/api/v0/organizations/register' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Acme Corporation",
    "slug": "acme-corp",
    "email": "contact@acme.com",
    "phoneNumber": "+1-555-123-4567",
    "description": "Leading provider of innovative solutions",
    "logo": "https://example.com/logo.png",
    "referralCampaignCode": "PARTNER2024"
}'

Response Example

201 - Example 1

{
    "success": true,
    "message": "Operation completed successfully",
    "data": {
        "id": "123",
        "name": "Example"
    }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Organization registered successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠409409

🔴500Server Error

Modified at 2025-08-22 18:48:44

List user's organizations