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 Tier API

The tier API from Brevo — 6 operation(s) for tier.

Brevo Tier 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 Tier. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 10 operations across 6 paths, and defines 35 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.

10 operations 6 paths 35 schemas 2 DELETE3 GET3 POST2 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 Tier 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 10

Across 6 paths, the API surfaces 10 operations — 2 DELETE, 3 GET, 3 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

tier 10
POST
/loyalty/tier/programs/{pid}/tier-groups
Create a tier group
createTierGroup 2 params body → 200400401403404409422
GET
/loyalty/tier/programs/{pid}/tier-groups
List tier groups
getListOfTierGroups 3 params → 200401403404422500
PUT
/loyalty/tier/programs/{pid}/tier-groups/{gid}
Update tier group
updateTierGroup 3 params body → 200401403404422500
DELETE
/loyalty/tier/programs/{pid}/tier-groups/{gid}
Delete tier group
deleteTierGroup 3 params → 204401403404409422500
GET
/loyalty/tier/programs/{pid}/tier-groups/{gid}
Get tier group
getTierGroup 4 params → 200401403404422500
GET
/loyalty/tier/programs/{pid}/tiers
List tiers
getLoyaltyProgramTier 3 params → 200401403404422500
POST
/loyalty/tier/programs/{pid}/tier-groups/{gid}/tiers
Create a tier
createTierForTierGroup 3 params body → 200401403404422500
DELETE
/loyalty/tier/programs/{pid}/tiers/{tid}
Delete tier
deleteTier 3 params → 204401403404422500
PUT
/loyalty/tier/programs/{pid}/tiers/{tid}
Update tier
updateTier 3 params body → 200401403404422500
POST
/loyalty/tier/programs/{pid}/contacts/{cid}/tiers/{tid}
Assign a tier
addSubscriptionToTier 4 params → 200401403404409422424500

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are tierGroup (10 properties), tier (9 properties), Tier_addSubscriptionToTier_Response_200 (7 properties), TierGroupDowngradeSchedule (5 properties). Each schema is shown below with its type and property counts.

LoyaltyTierProgramsPidTierGroupsGetParametersVersion
string
TierAccessConditionsItems
object
4 properties
LoyaltyTierProgramsPidTierGroupsGidPutRequestBodyContentApplicationJsonSchemaUpgradeStrategy
string
Select realtime to upgrade tier on real time balance updates. Select membershipanniversary to upgrade tier on subscription anniversary. Select tieranniversary…
LoyaltyTierProgramsPidTiersGetParametersVersion
string
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaUpgradeScheduleDurationUnit
string
Duration unit for the schedule.
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaUpgradeStrategy
string
Select realtime to upgrade tier on real time balance updates. Select membershipanniversary to upgrade tier on subscription anniversary. Select tieranniversary…
TierGroupDowngradeStrategy
string
Select realtime to downgrade tier on real time balance updates. Select membershipanniversary to downgrade tier on subscription anniversary. Select tierannivers…
TierGroupUpgradeScheduleDurationModifier
string
Modifier for the duration.
TierTierRewardsItems
object
3 properties
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaDowngradeScheduleDurationModifier
string
Modifier for the duration.
Tier_getLoyaltyProgramTier_Response_200
object
1 property
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaDowngradeSchedule
object
Schedule configuration for tier downgrades. Required when downgradeStrategy is set to a schedule-based strategy.
4 properties
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaUpgradeScheduleDurationModifier
string
Modifier for the duration.
TierGroupDowngradeScheduleDurationModifier
string
Modifier for the duration.
tierGroup
object
10 properties
TierGroupUpgradeStrategy
string
Select realtime to upgrade tier on real time balance updates. Select membershipanniversary to upgrade tier on subscription anniversary. Select tieranniversary…
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaDowngradeStrategy
string
Select realtime to downgrade tier on real time balance updates. Select membershipanniversary to downgrade tier on subscription anniversary. Select tierannivers…
TierGroupUpgradeScheduleDurationUnit
string
Duration unit for the schedule.
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaMeta
object
Additional metadata for the tier group.
1 property
TierGroupUpgradeSchedule
object
Schedule configuration for tier upgrades.
5 properties
tier
object
9 properties
Tier_getListOfTierGroups_Response_200
object
1 property
TierGroupDowngradeSchedule
object
Schedule configuration for tier downgrades.
5 properties
Tier_addSubscriptionToTier_Response_200
object
7 properties
errorModel
object
2 properties 1 required
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaDowngradeScheduleDurationUnit
string
Duration unit for the schedule.
LoyaltyTierProgramsPidTierGroupsPostRequestBodyContentApplicationJsonSchemaUpgradeSchedule
object
Schedule configuration for tier upgrades. Required when upgradeStrategy is set to a schedule-based strategy.
4 properties
LoyaltyTierProgramsPidTierGroupsGidTiersPostRequestBodyContentApplicationJsonSchemaTierRewardsItems
object
1 property
LoyaltyTierProgramsPidTierGroupsGidTiersPostRequestBodyContentApplicationJsonSchemaAccessConditionsItems
object
2 properties
LoyaltyTierProgramsPidTierGroupsGidPutRequestBodyContentApplicationJsonSchemaMeta
object
Additional metadata for the tier group.
1 property
TierGroupDowngradeScheduleDurationUnit
string
Duration unit for the schedule.
LoyaltyTierProgramsPidTiersTidPutRequestBodyContentApplicationJsonSchemaAccessConditionsItems
object
2 properties
LoyaltyTierProgramsPidTierGroupsGidGetParametersVersion
string
LoyaltyTierProgramsPidTierGroupsGidPutRequestBodyContentApplicationJsonSchemaDowngradeStrategy
string
Select realtime to downgrade tier on real time balance updates. Select membershipanniversary to downgrade tier on subscription anniversary. Select tierannivers…
LoyaltyTierProgramsPidTiersTidPutRequestBodyContentApplicationJsonSchemaTierRewardsItems
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

brevo-tier-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 Tier 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.