Domain Configuration - Messaging

Domain Configuration

Verify sender domains with your email provider for improved deliverability.

12.1 Add a Domain

Field	Type	Required	Description
domain	string	Yes	The sender domain to verify (e.g., events.example.com)
subdomain	string	No	Subdomain prefix for DNS records (e.g., mail)

curl -X POST "$KALTURA_MESSAGING_URL/domain/add" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "events.example.com",
    "subdomain": "mail"
  }'

Response: Contains the DNS records (CNAME, TXT) to configure for domain verification. Add these records to your DNS configuration before activating.

12.2 Activate a Domain

After DNS propagation, activate the domain.

Field	Type	Required	Description
domain	string	Yes	The domain to activate (must match a previously added domain)
subdomain	string	No	Subdomain prefix (must match the value used in domain/add)

curl -X POST "$KALTURA_MESSAGING_URL/domain/activate" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "events.example.com",
    "subdomain": "mail"
  }'

Response: Confirmation of domain activation. If DNS records are not yet propagated, the activation fails with an error.