Create an FCA Number for a Firm

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

Personal access token & OAuth2

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": "6bef9a77-91a0-48b0-a9ea-1ea8ed05b9d1",
  "status": "verified",
  "fca_number": 123456,
  "actioned_at": "2025-02-20T10:13:00+00:00",
  "rejected_reason": "Reason for rejection"
}