Get Attribute

Get custom attribute

GET/v1/attributes/{attributeId}

Use it in a workflow

Add a step and choose the Talon.One connector.
Pick the Get Attribute action (under management).
Fill in the fields below, then reference the result from later steps as {{getAttribute.response.data}}.

Request

Path parameters

attributeIdinteger (int64)required

The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in **Account** > **Tools** > **Attributes**.

Response

Returns 200 with an object. Read it in later steps with {{getAttribute.response.data.<field>}}.

idinteger (int64)

The internal ID of this entity.

createdstring (date-time)

The time this entity was created.

accountIdinteger (int64)

The ID of the account that owns this entity.

entitystring

The name of the entity that can have this attribute. When creating or updating the entities of a given type, you can include an `attributes` object with keys corresponding to the `name` of the custom attributes for that type.

One ofApplicationCampaignCustomerProfileCustomerSessionCartItemCouponEventGiveawayLoyaltyCardReferralStore

eventTypestring

namestring

The attribute name that will be used in API requests and Talang. E.g. if `name == "region"` then you would set the region attribute by including an `attributes.region` property in your request payload.

titlestring

The human-readable name for the attribute that will be shown in the Campaign Manager. Like `name`, the combination of entity and title must also be unique.

typestring

The data type of the attribute, a `time` attribute must be sent as a string that conforms to the [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) timestamp format.

One ofstringnumberbooleantime(list string)(list number)(list time)location(list location)

descriptionstring

A description of this attribute.

suggestionsarray<string>

A list of suggestions for the attribute.

hasAllowedListboolean

Whether or not this attribute has an allowed list of values associated with it.

Default false

restrictedBySuggestionsboolean

Whether or not this attribute's value is restricted by suggestions (`suggestions` property) or by an allowed list of value (`hasAllowedList` property).

Default false

editableboolean

Whether or not this attribute can be edited.

subscribedApplicationsIdsarray<integer (int64)>

A list of the IDs of the applications where this attribute is available.

subscribedCatalogsIdsarray<integer (int64)>

A list of the IDs of the catalogs where this attribute is available.

allowedSubscriptionsarray<string>

A list of allowed subscription types for this attribute. **Note:** This only applies to attributes associated with the `CartItem` entity.

eventTypeIdinteger (int64)

json

{
  "id": 6,
  "created": {},
  "accountId": 3886,
  "entity": "Event",
  "name": "pageViewed",
  "title": "Page view event",
  "type": "string",
  "description": "Event triggered when a customer displays a page.",
  "suggestions": [
    "string"
  ],
  "editable": true,
  "eventType": "pageViewed",
  "hasAllowedList": false
}

Need more? See the Talon.One guide for connection setup and behaviour shared by every action.

Was this page helpful?