Single-step claim flow: create the user, accept the invite, and mint a…

Used by /join/:invitationId. Refuses if a credential account already exists for the invite email — in that case the user must POST /api/v1/auth/sign-in followed by POST /api/v1/organizations/invitations/:invitationId/accept.

POST /api/v1/organizations/invitations/{invitationId}/sign-up

cURL

cURL

curl -sS -X POST "$FLUIDE_BASE_URL/api/v1/organizations/invitations/string/sign-up" \
  -H "Authorization: Bearer $FLUIDE_ACCESS_TOKEN" \
  -H "X-Fluide-Api-Key: $FLUIDE_API_KEY" \
  -H "X-Fluide-Client-Id: fluide-developer" \
  -H "Content-Type: application/json" \
  -d '{}'

const baseUrl = process.env.FLUIDE_BASE_URL;

const response = await fetch(`${baseUrl}/api/v1/organizations/invitations/string/sign-up`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.FLUIDE_ACCESS_TOKEN}`,
    'X-Fluide-Api-Key': process.env.FLUIDE_API_KEY,
    'X-Fluide-Client-Id': 'fluide-developer',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());

import os
import requests

base_url = os.environ["FLUIDE_BASE_URL"]
headers = {
        "Authorization": f"Bearer {os.environ['FLUIDE_ACCESS_TOKEN']}",
        "X-Fluide-Api-Key": os.environ["FLUIDE_API_KEY"],
        "X-Fluide-Client-Id": "fluide-developer",
}

response = requests.post(
    f"{base_url}/api/v1/organizations/invitations/string/sign-up",
    headers=headers,
    json={},
    timeout=30,
)
response.raise_for_status()
print(response.json())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String baseUrl = System.getenv("FLUIDE_BASE_URL");
HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create(baseUrl + "/api/v1/organizations/invitations/string/sign-up"))
    .header("Authorization", "Bearer " + System.getenv("FLUIDE_ACCESS_TOKEN"))
    .header("X-Fluide-Api-Key", System.getenv("FLUIDE_API_KEY"))
    .header("X-Fluide-Client-Id", "fluide-developer")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{}"))
    .build();
HttpResponse<String> response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());
if (response.statusCode() >= 400) throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
System.out.println(response.body());

<?php
$baseUrl = getenv("FLUIDE_BASE_URL");
$ch = curl_init($baseUrl . "/api/v1/organizations/invitations/string/sign-up");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('FLUIDE_ACCESS_TOKEN'),
        'X-Fluide-Api-Key: ' . getenv('FLUIDE_API_KEY'),
        'X-Fluide-Client-Id: fluide-developer',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{}",
]);
$response = curl_exec($ch);
if ($response === false) throw new RuntimeException(curl_error($ch));
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) throw new RuntimeException("HTTP $status: $response");
echo $response;

201

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {}
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

Authorizations

Authorization · string · header · required

Access token JWT. Use as Authorization: Bearer . In the API playground, paste the JWT only.

X-Fluide-Api-Key · string · header · default: fl_dev_your_key · required

Developer API key (fl_dev_...). Required on every API call with a machine access token.

X-Fluide-Client-Id · string · header · default: fluide-developer · required

First-party client audience. Must match the fluide_client_id claim on the JWT. Use fluide-developer for Connect.

Path Parameters

invitationId · string · required

invitationId identifier

Body

application/json

password · string · required

Required string length: 8 - 128

passwordConfirm · string · required

Required string length: 8 - 128

fluideClientId · enum<string> · required

First-party SPA the invitee is claiming the invite on behalf of.

Available options: fluide-admin, fluide-capital-admin, fluide-super, fluide-developer, fluide-onboarding, fluide-pay

hrAlternateEmail · string<email>

Optional alternate email used by the HR/payroll service to locate the canonical employment record (e.g. when the invitation address differs from the contact email recorded in fluide-hr).

Maximum string length: 255

Response

201

application/json

Created successfully

success · boolean · required

Whether the request succeeded

Example:

true

message · string · required

Human-readable outcome message (localized when i18n is configured)

Example:

"Operation completed successfully"

data · object

Endpoint-specific payload