Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
payload = {
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"contacts": [
{
"first_name": "Ava",
"last_name": "Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567",
"variable_values": {
"key": "value"
}
}
]
}
response = client.audience.create(**payload)
print(response)curl --request POST \\
--url https://voip-middlware.superu.ai/audience/create \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
--data '{
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"contacts": [
{
"first_name": "Ava",
"last_name": "Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567",
"variable_values": {
"key": "value"
}
}
]
}'{
"message": "Audience created successfully",
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"total_contacts": 1,
"contacts_added": 1,
"contacts": [
{
"id": "69f9a9a1c2647606b8c43154",
"first_name": "Ava",
"last_name": "Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567"
}
]
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"status": "error",
"code": "NOT_FOUND",
"message": "Resource not found."
}{
"status": "error",
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected server error occurred."
}{
"status": "error",
"code": "NOT_IMPLEMENTED",
"message": "This endpoint is not implemented for your workspace."
}Audiences
Create audience
Creates an audience and inserts initial contacts.
POST
/
audience
/
create
Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
payload = {
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"contacts": [
{
"first_name": "Ava",
"last_name": "Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567",
"variable_values": {
"key": "value"
}
}
]
}
response = client.audience.create(**payload)
print(response)curl --request POST \\
--url https://voip-middlware.superu.ai/audience/create \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
--data '{
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"contacts": [
{
"first_name": "Ava",
"last_name": "Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567",
"variable_values": {
"key": "value"
}
}
]
}'{
"message": "Audience created successfully",
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"total_contacts": 1,
"contacts_added": 1,
"contacts": [
{
"id": "69f9a9a1c2647606b8c43154",
"first_name": "Ava",
"last_name": "Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567"
}
]
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"status": "error",
"code": "NOT_FOUND",
"message": "Resource not found."
}{
"status": "error",
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected server error occurred."
}{
"status": "error",
"code": "NOT_IMPLEMENTED",
"message": "This endpoint is not implemented for your workspace."
}Authorizations
Your SuperU API key.
Body
application/json
Request body for Create audience.
Response
Audience created

