---
title: "Create a Realtime Attribute"
method: POST
path: "/audiences/{audienceId}/realtime_attributes"
tags: ["Realtime Journeys"]
---

# Create a Realtime Attribute

`POST /audiences/{audienceId}/realtime_attributes`

Create a Realtime Attribute

## Request body

- union
  - object
    - `name` string, required
    - `identifier` string, required
    - `type` 'imported', required
    - `description` string, nullable
    - `createdBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `updatedBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - object
    - `name` string, required
    - `identifier` string, required
    - `type` 'single', required
    - `description` string, nullable
    - `createdBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `updatedBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `realtimeKeyEventId` string
    - `filterRule` object
    - `valueColumn` string
    - `dataType` 'number' | 'string'
    - `duration` PartialRealtimeJourneyYamlRealtimeAttributeDurationSetting
      - `value` integer, required
      - `unit` 'hour' | 'day' | 'minute', required
    - `backfill` PartialRealtimeJourneyYamlRealtimeAttributeBackfillSetting, nullable
      - `attributeIdentifier` string, required
      - `timestampIdentifier` string, required
  - object
    - `name` string, required
    - `identifier` string, required
    - `type` 'list', required
    - `description` string, nullable
    - `createdBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `updatedBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `realtimeKeyEventId` string
    - `filterRule` object
    - `idColumn` string
    - `fields` string[]
    - `duration` PartialRealtimeJourneyYamlRealtimeAttributeDurationSetting
      - `value` integer, required
      - `unit` 'hour' | 'day' | 'minute', required
    - `maxItems` number
    - `actions` object[]
      - `action` 'delete_item' | 'clear', required
      - `realtimeKeyEventId` string, required
      - `filterRule` object, required
    - `aggregations` PartialRealtimeJourneyYamlRealtimeListAttributeAggregation[]
      - `name` string
      - `identifier` string
      - `aggregationType` 'first' | 'last' | 'sum' | 'min' | 'max' | 'distinct_list'
      - `column` string
  - object
    - `name` string, required
    - `identifier` string, required
    - `type` 'counter', required
    - `description` string, nullable
    - `createdBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `updatedBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `realtimeKeyEventId` string
    - `filterRule` object
    - `counterType` 'sliding' | 'total'
    - `increment` union
      - PartialRealtimeJourneyYamlRealtimeCounterAttributeIncrementSettingConst
        - `type` 'const', required
        - `value` number, required
      - PartialRealtimeJourneyYamlRealtimeCounterAttributeIncrementSettingField
        - `type` 'field', required
        - `value` string, required
    - `duration` PartialRealtimeJourneyYamlRealtimeAttributeDurationSetting
      - `value` integer, required
      - `unit` 'hour' | 'day' | 'minute', required
    - `backfill` PartialRealtimeJourneyYamlRealtimeAttributeBackfillSetting, nullable
      - `attributeIdentifier` string, required
      - `timestampIdentifier` string, required
    - `subDurations` object[]
      - `value` integer, required
      - `unit` 'hour' | 'day' | 'minute', required
      - `name` string, required
      - `identifier` string, required
  - object
    - `name` string, required
    - `identifier` string, required
    - `type` 'lookupCatalog', required
    - `description` string, nullable
    - `createdBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `updatedBy` User
      - `id` string
      - `td_user_id` string
      - `name` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `lookupCatalogTableName` string
    - `lookupCatalogColumns` object[]
      - `name` string, required
      - `dataType` string, required
    - `lookupKeys` object[]
      - `id` string, required
      - `type` string, required

## Response `200`

Create a Realtime Attribute

- object
  - `data` union
    - object
      - `id` string
      - `name` string, required
      - `identifier` string, required
      - `type` 'imported', required
      - `description` string, nullable
      - `createdBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `updatedBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - object
      - `id` string
      - `name` string, required
      - `identifier` string, required
      - `type` 'single', required
      - `description` string, nullable
      - `createdBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `updatedBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `realtimeKeyEventId` string
      - `filterRule` object
      - `valueColumn` string
      - `dataType` 'number' | 'string'
      - `duration` PartialRealtimeJourneyYamlRealtimeAttributeDurationSetting
        - `value` integer, required
        - `unit` 'hour' | 'day' | 'minute', required
      - `backfill` PartialRealtimeJourneyYamlRealtimeAttributeBackfillSetting, nullable
        - `attributeIdentifier` string, required
        - `timestampIdentifier` string, required
    - object
      - `id` string
      - `name` string, required
      - `identifier` string, required
      - `type` 'list', required
      - `description` string, nullable
      - `createdBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `updatedBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `realtimeKeyEventId` string
      - `filterRule` object
      - `idColumn` string
      - `fields` string[]
      - `duration` PartialRealtimeJourneyYamlRealtimeAttributeDurationSetting
        - `value` integer, required
        - `unit` 'hour' | 'day' | 'minute', required
      - `maxItems` number
      - `actions` object[]
        - `action` 'delete_item' | 'clear', required
        - `realtimeKeyEventId` string, required
        - `filterRule` object, required
      - `aggregations` PartialRealtimeJourneyYamlRealtimeListAttributeAggregation[]
        - `name` string
        - `identifier` string
        - `aggregationType` 'first' | 'last' | 'sum' | 'min' | 'max' | 'distinct_list'
        - `column` string
    - object
      - `id` string
      - `name` string, required
      - `identifier` string, required
      - `type` 'counter', required
      - `description` string, nullable
      - `createdBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `updatedBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `realtimeKeyEventId` string
      - `filterRule` object
      - `counterType` 'sliding' | 'total'
      - `increment` union
        - PartialRealtimeJourneyYamlRealtimeCounterAttributeIncrementSettingConst
          - `type` 'const', required
          - `value` number, required
        - PartialRealtimeJourneyYamlRealtimeCounterAttributeIncrementSettingField
          - `type` 'field', required
          - `value` string, required
      - `duration` PartialRealtimeJourneyYamlRealtimeAttributeDurationSetting
        - `value` integer, required
        - `unit` 'hour' | 'day' | 'minute', required
      - `backfill` PartialRealtimeJourneyYamlRealtimeAttributeBackfillSetting, nullable
        - `attributeIdentifier` string, required
        - `timestampIdentifier` string, required
      - `subDurations` object[]
        - `value` integer, required
        - `unit` 'hour' | 'day' | 'minute', required
        - `name` string, required
        - `identifier` string, required
    - object
      - `id` string
      - `name` string, required
      - `identifier` string, required
      - `type` 'lookupCatalog', required
      - `description` string, nullable
      - `createdBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `updatedBy` User
        - `id` string
        - `td_user_id` string
        - `name` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `lookupCatalogTableName` string
      - `lookupCatalogColumns` object[]
        - `name` string, required
        - `dataType` string, required
      - `lookupKeys` object[]
        - `id` string, required
        - `type` string, required

---

[API](https://skmtc.net/treasure/apis/cdp-api.md) · [All operations](https://skmtc.net/treasure/apis/cdp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/cdp-api/revisions/24caa8eb809b/schema)