Overview

The "Update subaccount" API is designed to allow Agents to modify the settings and attributes of an existing subaccount

Endpoints Available

Method	Endpoint	Description
PUT	v2023.07.31/emails/subaccount	Update the properties of an existing subaccount

Body Parameters

Parameter	Required / Optional	Description	Data Type
`"sending_domain"`	Required	Specifies the domain for sending emails from the subaccount	string
`"daily_send_limit"`	Required	Sets the daily email sending cap for the subaccount in terms of the number of emails	int
`"approved"`	Required	Indicates whether the subaccount is approved for sending emails, with "true" for approved and "false" for unapproved status	boolean

Response Definition

Response Item	Description	Data Type
`"user_id"`	The unique identifier for Supplier	int
`"sending_domain"`	The domain used for sending emails	string
`"subaccount_id"`	A unique subaccount identifier associated with the user	string
`"dns_value"`	A DNS verification value used to verify domain ownership	string
`"dns_validation_status"`	Indicates whether DNS validation is successful (true) or not (false)	boolean
`"dkim_value"`	The DKIM (DomainKeys Identified Mail) value used for email authentication	string
`"dkim_validation_status"`	Indicates whether DKIM validation is successful (true) or not (false)	boolean
`"spf_value"`	The SPF (Sender Policy Framework) value defining authorized sources to send emails	string
`"spf_validation_status"`	Indicates whether SPF validation is successful (true) or not (false)	boolean
`"daily_send_limit"`	The maximum number of emails that can be sent per day	int
`"approved"`	Indicates whether the user is approved (true) to send emails or not (false)	boolean
`"mc_user_id"`	The unique identifier for Supplier	int

Sample Request

curl --request PUT \
     --url https://api.ciiruspartners.com/v2023.07.31/emails/subaccount \
     --data '
{
  "approved": true,
  "sending_domain": "ciiruspartners.com",
  "daily_send_limit": 420
}
'

Sample Response

{
  "user_id": 42330,
  "sending_domain": "ciirus.com",
  "subaccount_id": "subaccount-42330-partner-api",
  "dns_value": "mandrill_verify.1LJTwMFrjPZ7EY2KX1_D_V",
  "dns_validation_status": true,
  "dkim_value": "v=DKIM1; k=rsa; p=L9TkQB1gZJ2cZnSe1Kf/dUM3LShVe9jtiRhzlEruVNbZvBtWeSj6+D9XKm/19D2NO5oyG4z3btaJqYbNZl+EJalB07eZy6tzVTeKfQs62crRbBnvUZbP9iLQlSbRIBjraPe9Ij5aPhQWdRlNBbUWbVjoVH39G9Mz2jbJlqG1e8h4r7gBDAQUECAHw;",
  "dkim_validation_status": true,
  "spf_value": "v=spf1 include:spf.mandrillapp.com ?all",
  "spf_validation_status": true,
  "daily_send_limit": 420,
  "approved": true,
  "mc_user_id": 42330
}