Create an FCA Number for a Firm

POST /api/v1/firm/{firm}/fca

Personal access token & O auth2

Headers

Path parameters

firm integer Required

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/firm/fca' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"fca_number":123456}'

Request examples

# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "fca_number": 123456
}

Response examples (201)

{
  "uuid": "5f4ead6c-2cf7-4f27-a4c8-1b8455ec0d38",
  "status": "verified",
  "fca_number": 123456,
  "actioned_at": "2025-04-22T13:44:16+01:00",
  "rejected_reason": "Reason for rejection"
}