Skip to main content

Import Audience Data External API

POST 
/ma_audience/import-audience/

Import audience data through external API with comprehensive support for member management. This endpoint allows external systems to create or update audience information in OmniSegment.

Key Features:

  • Audience data validation and processing
  • Multiple merge key options (member_sn, phone, email, line_id)
  • Custom fields support
  • Tag management (append/replace modes)
  • Multi-site organization support
  • Data encryption capabilities
  • OneAudience ID integration
  • Headless account creation

Merge Key Options:

  • member_sn: Primary member identifier
  • phone: Phone number based matching
  • email: Email address based matching
  • line_id: LINE messenger ID based matching

Tag Modes:

  • append: Add new tags to existing tags (default)
  • replace: Replace all existing tags with new ones

Important Notes:

  • If no merge_key is specified, the organization's default merge key is used
  • The identifier_field description: Specifies the field name used to identify members. This field determines which field the API will use to search and associate member information. If identifier_field is not provided in the request, the lookup and association will be performed using member_sn.
  • For organizations with OneAudience enabled, both 'brand' and the audience identifier field are required
  • Custom fields must be pre-configured in the organization settings
  • For headless accounts, set 'is_headless_account' to true

Request​

Responses​