Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
payload = {
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"contacts": [
{
"first_name": "Emma",
"last_name": "Watson",
"email": "emma@example.com",
"country_code": "+1",
"phone_number": "5551234523",
"variable_values": {
"key": "value"
}
}
]
}
response = client.audience.add_contacts(**payload)
print(response)curl --request POST \\
--url https://voip-middlware.superu.ai/audience/add-contacts \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
--data '{
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"contacts": [
{
"first_name": "Emma",
"last_name": "Watson",
"email": "emma@example.com",
"country_code": "+1",
"phone_number": "5551234523",
"variable_values": {
"key": "value"
}
}
]
}'{
"message": "Successfully added 1 contact(s) to audience",
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"audience_name": "Demo Audience - Q1",
"contacts_added": 1,
"total_contacts_provided": 1,
"contacts": [
{
"id": "69f9aa813ff1953354e5e428",
"first_name": "Emma",
"last_name": "Watson",
"email": "emma@example.com",
"country_code": "+1",
"phone_number": "5551234523"
}
]
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"message": "Invalid request payload",
"status": "error",
"error": "Bad Request",
"code": "BAD_REQUEST"
}{
"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
Add contacts to audience
Adds one or more contacts to an audience.
POST
/
audience
/
add-contacts
Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
payload = {
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"contacts": [
{
"first_name": "Emma",
"last_name": "Watson",
"email": "emma@example.com",
"country_code": "+1",
"phone_number": "5551234523",
"variable_values": {
"key": "value"
}
}
]
}
response = client.audience.add_contacts(**payload)
print(response)curl --request POST \\
--url https://voip-middlware.superu.ai/audience/add-contacts \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
--data '{
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"contacts": [
{
"first_name": "Emma",
"last_name": "Watson",
"email": "emma@example.com",
"country_code": "+1",
"phone_number": "5551234523",
"variable_values": {
"key": "value"
}
}
]
}'{
"message": "Successfully added 1 contact(s) to audience",
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"audience_name": "Demo Audience - Q1",
"contacts_added": 1,
"total_contacts_provided": 1,
"contacts": [
{
"id": "69f9aa813ff1953354e5e428",
"first_name": "Emma",
"last_name": "Watson",
"email": "emma@example.com",
"country_code": "+1",
"phone_number": "5551234523"
}
]
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"message": "Invalid request payload",
"status": "error",
"error": "Bad Request",
"code": "BAD_REQUEST"
}{
"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 Add contacts to audience.

