Skip to content
Docs
English
Esc
navigateopen⌘Jpreview

Request missing user data fields

Requests missing profile/data fields from a user. Scoped to your integration’s institution via Basic Auth credentials.

POST/users/{id}/data-collection-requests
Path parameters
idstringrequired
Request body
requiredapplication/json
fieldsDataCollectionFieldSpec[]required
Show properties
Array of DataCollectionFieldSpec
fieldTypestringrequired
Allowed:CUSTOMPERSONALSTATISTIC
customFieldIdstring | null
hardcodedFieldstring | null
sendNotificationboolean
default: false
Responses
201Data collection request created
dataobjectrequired
Show properties
userIdstringrequired
createdintegerrequired
notifiedbooleanrequired
metaResponseMetarequired
Show properties
requestIdstringrequired
timestampstring<date-time>required
versionstringrequired
Allowed:v4
400Bad Request
typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
401Unauthorized
typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
404Not Found
typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
429Too Many Requests
typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
500Internal Server Error
typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
Request
curl -X POST "https://fuxam.app/api/v4/users/string/data-collection-requests" \
  -H "Content-Type: application/json" \
  -d '{
  "fields": [
    {
      "fieldType": "CUSTOM",
      "customFieldId": "string",
      "hardcodedField": "string"
    }
  ],
  "sendNotification": false
}'
Response
{
  "data": {
    "userId": "string",
    "created": 0,
    "notified": true
  },
  "meta": {
    "requestId": "req_1234567890_abc",
    "timestamp": "2026-06-02T07:00:00.000Z",
    "version": "v4"
  }
}