Create Historical Points Custom Fields

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

You can use this API to create custom fields for historical points import as part of your loyalty migration setup.

Custom fields allow you to attach additional metadata to each historical point's entry when onboarding customers from an external or legacy loyalty system.

You can use this API to:

  • Store additional attributes from the source loyalty platform.
  • Define required fields before uploading historical points.
  • Reference these fields during the historical points upload process. Ensure that you execute this API before initiating historical points import.

Example request

curl --location 'https://eu.intouch.capillarytech.com/v2/historicalPoints/saveCustomFields' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic bmVlcmFqLmRhNGNjZGMzMzQzMWVmOWFjOQ==' \
--data '{
    "customFieldName": [
        "testField2"
    ]
}'

Prerequisites

Custom fields must be created before importing historical points data. These fields store additional metadata about each historical point's entry.

📘

Note

This API is for organizations migrating customers from an external or legacy loyalty program to Capillary. Custom fields allow you to capture additional metadata from the source system during import.

Body parameters

FieldTypeRequired?Description
customFieldNamearrayYesList of custom field names to create. Each name must be unique within the org.

Example response

{
    "status": true,
    "message": "SUCCESSFULLY_SAVED_HISTORICAL_POINTS_CUSTOM_FIELD",
    "warnings": []
}

Response parameters

ParameterDatatypeDescription
statusbooleantrue if the operation was successful, false otherwise.
messagestringDescriptive message about the result of the operation.
warningsarrayList of warning messages.

Error & warning codes

CodeDescription
2202Error in saving historical points custom fields. Returned when any exception occurs during the save operation (e.g., database error, thrift service failure).
Body Params
customFieldName
array of strings
customFieldName
Headers
string
required
Defaults to Basic bmVlcmFqLmRvYzpiNGFmODA0MDA5Y2IwMzZhNGNjZGMzMzQzMWVmOWFj
Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json