post https://{host}/api_gateway/rewards/core/v1/brand/customfield
This API is used to create a custom field for a particular org.
Note
- Create/Update reward: Add a custom field in the payload which will be mapped to that reward with the scope REWARD
- Create/Update promotion: Add a custom field in the payload which will be mapped to that reward with the scope CATALOGUE_PROMOTION
Note
- For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call .
- Start time and end time are in UTC time zone
Prerequisites
- Authentication: Basic authentication
- Default access group
Resource information
| URI | /api_gateway/rewards/core/v1/brand/customfield |
| HTTP Method | POST |
| Pagination | No |
| Batch support | No |
| Rate limit information | None |
API endpoint example
https://eucrm.cc.capillarytech.com/api_gateway/rewards/core/v1/brand/customfield
Request body parameters
| Parameter Name | Data Type | Description |
|---|---|---|
| name* | String | Name of the custom field. |
| orgId | String | Org identifier of the org. |
| description* | String | Description of the field. |
| isMandatory | Boolean | Indicates if the field is mandatory. |
| isActive | Boolean | Status of the field. Ex: true. |
| scope* | Enum | Pass scope as REWARD in case of adding custom fields in creating/updating reward and pass CATALOGUE_PROMOTION in case of adding custom fields in updating/creating a promotion. Supported values: REWARD, CATALOGUE_PROMOTION. |
| defaultValue | String | A user-defined default value associated with the custom field. |
| dataType* | String | Type of data for the field. Ex: String. |
{
"orgId": 100458,
"name": "CF1A112",
"description": "CF1A112",
"isMandatory": false,
"isActive": true,
"scope": "REWARD",
"defaultValue": null,
"dataType": "STRING"
}
Response parameters
| Parameter Name | Data Type | Description |
|---|---|---|
| id | Integer | Unique identifier for the custom field. |
| orgId | Integer | Org identifier of the org. |
| name | String | Name of the custom field. |
| description | String | Description of the custom field. |
| isMandatory | Boolean | Indicates if the field is mandatory. |
| isActive | Boolean | Status of the field. |
| scope | String | Scope of the field. |
| defaultValue | String | Default value of the field. |
| dataType | String | Type of data for the field. |
| createdBy | Integer | User identifier who created the field. |
| createdOn | Date | Creation date and time of the field. |
| lastUpdatedBy | Integer | User identifier who last updated the field. |
| lastUpdatedOn | Date | Last update date and time of the field. |
{
"id": 209,
"orgId": 100458,
"name": "CF1A112",
"description": "CF1A112",
"isMandatory": false,
"isActive": true,
"scope": "REWARD",
"defaultValue": null,
"dataType": "STRING",
"createdBy": 75086856,
"createdOn": null,
"lastUpdatedBy": 75086856,
"lastUpdatedOn": null
}