Listeners

The Listener Object

A Listener is a profile record in Audata for a listener of the station they belong to. Usually these records are created when a listener wins a prize from a station or enters a competition, however they can also be manually created in the app or via the API.

Value	Type	Description
uuid	string	Listener UUID.
first_name	string	First name.
last_name	string	Last name.
email	string	Email.
phone_number	string	Phone number.
dob	string	Date of birth.
gender	string	Gender.
address1	string	Address line 1.
address2	string	Address line 2.
suburb	string	Suburb.
postcode	string	Postcode.
state	string	State.
country	string	Country.
custom_data	object	Custom listener data when present.
station_uuid	string	Station UUID when station_id is present.
created_at	string	Record creation timestamp.
updated_at	string	Record update timestamp.

📘

TIP

Developers may assume that you need to create a Listener record before creating a Prize, but that's not the case. You can, if you want to, but you can also create the Prize record and provide the redemption URL to the listener yourself, or let Audata send them a notification automatically to collect their details.