Create an FCA Number for a Firm

POST /api/v1/firm/{firm}/fca
Personal access token & O auth2

Headers

  • X-PLANNR-ACCOUNT-UUID string

Path parameters

  • firm string Required

    The firm.

application/json

Body Required

  • fca_number integer Required

    An FCA Number in a 6 or 7-digit format

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
    • uuid string

      The UUID of the resource.

    • fca_number integer

      FCA Number

    • status string

      FCA Number Status, possible values are pending, verified and rejected

    • rejected_reason string

      Reason for rejection

    • actioned_at string

      DateTime FCA Number was verified or rejected
POST /api/v1/firm/{firm}/fca 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/firm/architecto/fca' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"fca_number":123456}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "fca_number": 123456
}
Response examples (201) 
{
  "uuid": "661c57a5-bffd-48d5-8cd1-4cfed85a9fa1",
  "status": "verified",
  "fca_number": 123456,
  "actioned_at": "2025-08-27T17:31:24+01:00",
  "rejected_reason": "Reason for rejection"
}