Overview
Each object in the Helix API is intended to offer the appropriate level of visibility for functionality related to that object. However, we strive to maintain a level of consistency across all objects to make using the Helix API as a whole a pleasant experience.
Common Properties
| Property | Summary | Notes |
|---|---|---|
customerId | Helix-generated unique Id for a customer. | Used by almost every single route in Helix. It is recommended you store this in your system as well. |
tag | A unique identifier for that object in your system. | - Use this to tie data in your system to data in Helix - Must be unique across your entire program - Possible to update this value, but discouraged - Stored as an unencrypted string 50 characters in length - Do NOT pass personally identifiable information in this property, including but not limited to SSN, TIN, debit/credit card numbers, etc. |
{object}Id | The Helix-generated unique identifier for {object}. | Usually returned when a /{object}/create or /{object}/initiate route is called. May be 32- or 64-bit integer, see specific route for details |
Common Actions
| Action | Summary | Notes |
|---|---|---|
/{object}/create | Creates a new {object} in Helix | {object} will be created and is immediatelyavailable for use |
/{object}/initiate | Initiates creation of a new {object}in Helix | - Always used in tandem with /{object}/verify- On success, {object} is created, but notavailable for use until /{object}/verify iscalled successfully |
/{object}/verify | Verifies creation of a new {object}in Helix | - Always used in tandem with /{object}/initiate- On success, {object} will be ready forimmediate use |
/{object}/archive | Permanently deactivates a specific{object} in Helix | - It is never possible to re-activate the {object}via Helix API - Sometimes it is possible to re-activate the {object} via the Helix Admin console |
/{object}/get | Retrieves a single {object}based on a Helix-generated {object}Id | If {object} is not found, either an HTTP 400may occur or the data property may be null. Depends on the specific route |
/{object}/getByTag | Returns a single instance of an{object} based on the tagsupplied when /{object}/create or/{object}/initiate was called | If {object} is not found, either an HTTP 400may occur or the data property may be null. Depends on the specific route |
/{object}/list | Returns a list of {object}s basedon supplied parameter(s) | Always returns a list of 0 or more {object}s |
Updated about 1 year ago