{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"**This endpoint allows you to associate a specific authenticated domain with a subuser. It can be used to associate up to five authenticated domains.**\n\n\nThis functionality allows subusers to send mail using their parent's domain. Authenticated domains can be associated with (i.e. assigned to) subusers from a parent account. To associate an authenticated domain with a subuser, the parent account must first authenticate and validate the domain. The parent may then associate the authenticated domain via the subuser management tools.\n\n\nA subuser can have up to five associated authenticated domains. To see the domains that have already been associated with this user, you can [use the API to list the domains currently associated with the subuser](https://www.twilio.com/docs/sendgrid/api-reference/domain-authentication/list-the-authenticated-domain-associated-with-a-subuser-multiple).\n\n\nWhen selecting a domain to send email from, SendGrid checks for domains in the following order and chooses the first one that appears in the hierarchy: \n1. Domain assigned by the subuser that matches the email's `From` address domain. \n2. The subuser's default domain. \n3. Domain assigned by the parent user that matches the `From` address domain. \n4. Parent user's default domain. \n5. sendgrid.net","properties":{"path":{"type":"object","properties":{"domain_id":{"type":"integer","description":"ID of the authenticated domain to associate with the subuser."}},"required":["domain_id"],"additionalProperties":false},"body":{"type":"object","properties":{"username":{"type":"string","description":"Username to associate with the authenticated domain."}},"required":["username"],"examples":[{"username":"jdoe"}]}},"required":["path"],"additionalProperties":false},"name":"Associate an authenticated domain with a given user, for up to five domains.","id":"sendgrid.domain_authentication.associatesubuserwithdomainmultiple","example":{"path":{"domain_id":1}},"maxRequests":1,"summary":false}}