List profiles in organization
Retrieves all sender profiles within an organization, including brand information for each profile. Profiles represent different brands, departments, or use cases within an organization, each with their own messaging configuration.
Header Parameters
Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://api.sent.dm/v3/profiles"{
"success": true,
"data": {
"profiles": [
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"organization_id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Marketing Team",
"email": "team@acme.com",
"icon": "https://example.com/marketing-icon.png",
"description": "Marketing department sender profile",
"short_name": "MKT",
"status": "approved",
"created_at": "2025-12-11T21:50:50.1574292+00:00",
"updated_at": "2026-03-06T21:50:50.1574304+00:00",
"allow_contact_sharing": true,
"allow_template_sharing": false,
"inherit_contacts": true,
"inherit_templates": false,
"inherit_tcr_brand": false,
"inherit_tcr_campaign": false,
"billing_model": "profile",
"sending_phone_number_profile_id": null,
"sending_whatsapp_number_profile_id": null,
"sending_phone_number": null,
"whatsapp_phone_number": null,
"allow_number_change_during_onboarding": null,
"waba_id": null,
"billing_contact": null,
"brand": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"tcr_brand_id": null,
"status": null,
"identity_status": null,
"universal_ein": null,
"csp_id": null,
"submitted_to_tcr": false,
"submitted_at": null,
"is_inherited": false,
"created_at": "2025-12-11T21:50:50.1574315+00:00",
"updated_at": null,
"contact": {
"name": "John Smith",
"business_name": "Acme Corp",
"role": null,
"phone": null,
"email": "john@acmecorp.com",
"phone_country_code": null
},
"business": {
"legal_name": "Acme Corporation LLC",
"tax_id": null,
"tax_id_type": null,
"entity_type": null,
"street": null,
"city": null,
"state": null,
"postal_code": null,
"country": "US",
"url": null,
"country_of_registration": null
},
"compliance": {
"vertical": "PROFESSIONAL",
"brand_relationship": "SMALL_ACCOUNT",
"primary_use_case": null,
"expected_messaging_volume": null,
"is_tcr_application": true,
"phone_number_prefix": null,
"destination_countries": [],
"notes": null
}
}
}
]
},
"error": null,
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:50.1574972+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "RESOURCE_005",
"message": "Organization not found",
"details": null,
"doc_url": "https://docs.sent.dm/errors/RESOURCE_005"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:50.157501+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "INTERNAL_001",
"message": "Failed to retrieve profiles. Please contact support with request ID: req_7X9zKp2jDw",
"details": null,
"doc_url": "https://docs.sent.dm/errors/INTERNAL_001"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:50.1575017+00:00",
"version": "v3"
}
}Delete a template DELETE
Deletes a template by ID. Optionally, you can also delete the template from WhatsApp/Meta by setting delete_from_meta=true.
Get profile by ID GET
Retrieves detailed information about a specific sender profile within an organization, including brand and KYC information if a brand has been configured.