How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Brevo Master Account API

The masterAccount API from Brevo — 21 operation(s) for masteraccount.

Brevo Master Account API is one of 53 APIs that Brevo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include MasterAccount. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 26 operations across 21 paths, and defines 75 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.brevo.com/v3.

26 operations 21 paths 75 schemas 3 DELETE8 GET7 POST8 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.brevo.com/v3
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Brevo Master Account API declares 1 security scheme for authenticating requests. An API key is passed in the header as api-key (api-key).

  • api-key — The API key should be passed in the request headers as api-key for authentication.

Paths & Operations 26

Across 21 paths, the API surfaces 26 operations — 3 DELETE, 8 GET, 7 POST, 8 PUT. Each is listed below with its method, path, parameters, and response codes.

masterAccount 26
GET
/corporate/subAccount
Get the list of all the sub-accounts of the master account.
getTheListOfAllTheSubAccountsOfTheMasterAccount 3 params → 200400
POST
/corporate/subAccount
Create a new sub-account under a master account.
createANewSubAccountUnderAMasterAccount 1 param body → 201400
GET
/corporate/subAccount/{id}
Get sub-account details
getSubAccountDetails 2 params → 200400
DELETE
/corporate/subAccount/{id}
Delete a sub-account
deleteASubAccount 2 params → 204400404
PUT
/corporate/subAccount/{id}/plan
Update sub-account plan
updateSubAccountPlan 2 params body → 204400403
PUT
/corporate/subAccounts/plan
Update sub-accounts plan
updateSubAccountsPlan 1 param body → 202400403
POST
/corporate/ssoToken
Generate SSO token to access admin account
generateSsoTokenToAccessAdminAccount 1 param body → 200400403
POST
/corporate/subAccount/ssoToken
Generate SSO token to access sub-account
generateSsoTokenToAccessSubAccount 1 param body → 200400403
GET
/corporate/masterAccount
Get the details of requested master account
getTheDetailsOfRequestedMasterAccount 1 param → 200400
POST
/corporate/subAccount/key
Create an API key for a sub-account
createAnApiKeyForASubAccount 1 param body → 201400
PUT
/corporate/subAccount/{id}/applications/toggle
Enable/disable sub-account application(s)
enableDisableSubAccountApplicationS 2 params body → 204400403
POST
/corporate/group
Create a new group of sub-accounts
createANewGroupOfSubAccounts 1 param body → 201400
GET
/corporate/ip
List of all IPs
listOfAllIPs 1 param → 200400
POST
/corporate/subAccount/ip/associate
Associate an IP to sub-accounts
associateAnIpToSubAccounts 1 param body → 201400
PUT
/corporate/subAccount/ip/dissociate
Dissociate an IP to sub-accounts
dissociateAnIpToSubAccounts 1 param body → 204400
GET
/corporate/group/{id}
GET a group details
getAGroupDetails 2 params → 200400
PUT
/corporate/group/{id}
Update a group of sub-accounts
updateAGroupOfSubAccounts 2 params body → 204400
DELETE
/corporate/group/{id}
Delete a group
deleteAGroup 2 params → 204400
PUT
/corporate/group/unlink/{groupId}/subAccounts
Delete sub-account from group
deleteSubAccountFromGroup 2 params body → 204400
POST
/corporate/user/invitation/send
Send invitation to an admin user
inviteAdminUser 1 param body → 201400
PUT
/corporate/user/invitation/{action}/{email}
Resend / cancel admin user invitation
resendCancelAdminUserInvitation 3 params → 200400
DELETE
/corporate/user/revoke/{email}
Revoke an admin user
revokeAnAdminUser 2 params → 204400
GET
/corporate/invited/users
Get the list of all admin users
getCorporateInvitedUsersList 4 params → 200400
GET
/corporate/user/{email}/permissions
Check admin user permissions
getCorporateUserPermission 2 params → 200400
PUT
/corporate/user/{email}/permissions
Change admin user permissions
changeAdminUserPermissions 2 params body → 204400
GET
/corporate/groups
Get the list of groups
getSubAccountGroups 1 param → 200400

Schemas 75

The contract defines 75 schemas that model the data the API accepts and returns. The most detailed are CorporateInvitedUsersGetResponsesContentApplicationJsonSchemaUsersItemsFeatureAccess (8 properties), CorporateUserEmailPermissionsGetResponsesContentApplicationJsonSchemaFeatureAccess (8 properties), CorporateMasterAccountGetResponsesContentApplicationJsonSchemaPlanInfoFeaturesItems (7 properties), Master_account_getTheDetailsOfRequestedMasterAccount_Response_200 (7 properties). Each schema is shown below with its type and property counts.

CorporateUserEmailPermissionsGetResponsesContentApplicationJsonSchemaGroupsItems
object
Groups details
2 properties
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoCredits
object
Credits quota and remaining credits on the sub-account
5 properties
CorporateMasterAccountGetResponsesContentApplicationJsonSchemaBillingInfo
object
Billing details of the master account organization
4 properties
CorporateUserInvitationSendPostRequestBodyContentApplicationJsonSchemaPrivilegesItemsPermissionsItems
string
Master_account_updateSubAccountsPlan_Response_202
object
Empty response body
UpdateSubAccountPlanRequestBadRequestError
object
2 properties 2 required
CorporateMasterAccountGetResponsesContentApplicationJsonSchemaBillingInfoName
object
Billing name of master account holder
2 properties
CorporateGroupsGetResponsesContentApplicationJsonSchemaItems
object
2 properties
Master_account_getCorporateInvitedUsersList_Response_200
object
1 property
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
CorporateUserInvitationSendPostResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoFeaturesSalesUsers
object
Sales and service users to use phone, sales and conversations
2 properties
CorporateMasterAccountGetResponsesContentApplicationJsonSchemaPlanInfo
object
Plan details
6 properties
CorporateUserInvitationSendPostRequestBodyContentApplicationJsonSchemaPrivilegesItemsFeature
string
Feature name
CorporateInvitedUsersGetResponsesContentApplicationJsonSchemaUsersItemsFeatureAccess
object
Feature accessiblity given to the user. (Required only if status is active)
8 properties
Master_account_getTheListOfAllTheSubAccountsOfTheMasterAccount_Response_200
object
2 properties
CorporateMasterAccountGetResponsesContentApplicationJsonSchemaPlanInfoFeaturesItems
object
7 properties
CorporateSubAccountIdPlanPutRequestBodyContentApplicationJsonSchemaFeatures
object
Features details to update
4 properties
CorporateUserInvitationSendPostRequestBodyContentApplicationJsonSchemaPrivilegesItems
object
Privileges given to the user
2 properties
CorporateInvitedUsersGetResponsesContentApplicationJsonSchemaUsersItems
object
5 properties 5 required
CorporateSubAccountGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoFeaturesLandingPage
object
Landing page details / Not applicable on ENTv2
2 properties
CorporateUserEmailPermissionsPutRequestBodyContentApplicationJsonSchemaPrivilegesItems
object
Permission on features
2 properties
GetCorporateUserPermissionRequestBadRequestError
object
2 properties 2 required
CorporateInvitedUsersGetResponsesContentApplicationJsonSchemaUsersItemsGroups
object
Admin user groups list
2 properties
Master_account_inviteAdminUser_Response_201
object
1 property
Master_account_associateAnIpToSubAccounts_Response_201
object
CorporateMasterAccountGetResponsesContentApplicationJsonSchemaPlanInfoPlanPeriod
string
Plan period type
CorporateSubAccountSsoTokenPostRequestBodyContentApplicationJsonSchemaTarget
string
Set target after login success automation - Redirect to Automation after login emailcampaign - Redirect to Email Campaign after login contacts - Redirect to Co…
Master_account_getAGroupDetails_Response_200
object
3 properties
CorporateGroupIdGetResponsesContentApplicationJsonSchemaGroup
object
3 properties
EnableDisableSubAccountApplicationSRequestBadRequestError
object
2 properties 2 required
CorporateUserEmailPermissionsGetResponsesContentApplicationJsonSchemaFeatureAccess
object
Granular feature permissions given to the user.
8 properties
Master_account_getSubAccountDetails_Response_200
object
5 properties
CorporateSubAccountIdPlanPutResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
Master_account_resendCancelAdminUserInvitation_Response_200
object
1 property
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoCreditsExternalFeeds
object
externalFeeds credits remaining on the sub-account
2 properties
CorporateSubAccountGetResponsesContentApplicationJsonSchemaSubAccountsItems
object
5 properties 5 required
CorporateSubAccountsPlanPutRequestBodyContentApplicationJsonSchemaCredits
object
Credit details to update
5 properties
CorporateGroupIdGetResponsesContentApplicationJsonSchemaUsersItems
object
3 properties
CorporateMasterAccountGetResponsesContentApplicationJsonSchemaBillingInfoAddress
object
Billing address of master account
5 properties
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoCreditsWpSubscribers
object
Push credits remaining on the sub-account
2 properties
UpdateSubAccountsPlanRequestBadRequestError
object
2 properties 2 required
CorporateUserEmailPermissionsPutRequestBodyContentApplicationJsonSchemaPrivilegesItemsPermissionsItems
string
Master_account_createANewGroupOfSubAccounts_Response_201
object
1 property
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoFeaturesInbox
object
Inbox details / Not applicable on ENTv2
2 properties
CorporateMasterAccountGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
errorModel
object
2 properties 1 required
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoCreditsSms
object
SMS credits remaining on the sub-account
2 properties
InviteAdminUserRequestBadRequestError
object
2 properties 2 required
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoCreditsEmails
object
Email credits remaining on the sub-account
2 properties
Master_account_getTheDetailsOfRequestedMasterAccount_Response_200
object
7 properties
CorporateSubAccountsPlanPutResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
CorporateSubAccountIdApplicationsTogglePutResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
CorporateSubAccountPostRequestBodyContentApplicationJsonSchemaLanguage
string
Set the language of the sub-account
Master_account_getCorporateUserPermission_Response_200
object
Check admin user permissions
4 properties 4 required
CorporateUserEmailPermissionsGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
CorporateSubAccountsPlanPutRequestBodyContentApplicationJsonSchemaFeatures
object
Features details to update
3 properties
CorporateGroupIdGetResponsesContentApplicationJsonSchemaSubAccountsItems
object
3 properties
CorporateUserInvitationActionEmailPutParametersAction
string
Master_account_createANewSubAccountUnderAMasterAccount_Response_201
object
1 property 1 required
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoFeatures
object
Features available on the sub-account
4 properties
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoFeaturesUsers
object
Marketing users to manage the marketing channels
2 properties
GetSubAccountDetailsRequestBadRequestError
object
2 properties 2 required
Master_account_createAnApiKeyForASubAccount_Response_201
object
2 properties 2 required
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfo
object
Sub-account plan details
3 properties
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaGroupsItems
object
2 properties
CorporateIpGetResponsesContentApplicationJsonSchemaItems
object
3 properties
CorporateUserEmailPermissionsPutRequestBodyContentApplicationJsonSchemaPrivilegesItemsFeature
string
feature name
GetTheListOfAllTheSubAccountsOfTheMasterAccountRequestBadRequestError
object
2 properties 2 required
CorporateSubAccountIdGetResponsesContentApplicationJsonSchemaPlanInfoCreditsWhatsapp
object
Whatsapp credits remaining on the sub-account
2 properties
CorporateSubAccountGetResponsesContentApplicationJsonSchemaSubAccountsItemsGroupsItems
object
2 properties
GetTheDetailsOfRequestedMasterAccountRequestBadRequestError
object
2 properties 2 required
CorporateSubAccountIdPlanPutRequestBodyContentApplicationJsonSchemaCredits
object
Credit details to update
5 properties
getSsoToken
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

brevo-masteraccount-api-openapi.yml Raw ↑

Other APIs Brevo publishes across the network.

brevo Agent Status API
brevo Automated Messages API
brevo Campaign Statistics API
brevo Categories API
brevo Contact Attributes API
brevo Contact Lists API
brevo Contacts API
brevo Email Activity API
brevo Email Campaigns API
brevo Email Templates API
brevo Folders API
brevo Import API
Where this information came from

This is an independent, third-party profile of Brevo Master Account API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.