# Reference ## Account

$client->account->getAccount() -> GetAccountResponse

#### 📝 Description

Retrieves details of your Brevo account. **Use this to:** - Get account information (email, name, company, address) - Check plan details (type, credits, expiration) - Get relay information (for transactional emails) - Check Marketing Automation status - View date/time preferences and account settings - Access organization and user identifiers **Key information returned:** - Complete account details (organization ID, user ID, company information) - Address and contact information - Plan configurations and credit allocations across different verticals - Marketing Automation settings and tracker key - SMTP relay configuration for transactional emails - Date/time preferences and account settings - Enterprise features availability status **Important considerations:** - Provides comprehensive account overview for billing and configuration management - Essential for understanding current plan limitations and feature availability - Marketing Automation key required for advanced automation features - Plan verticals show detailed breakdown across Marketing, Chat, and CRM categories - Relay configuration crucial for transactional email setup and deliverability - Date/time preferences affect campaign scheduling and reporting displays - Enterprise status determines access to advanced features and sub-account management

#### 🔌 Usage

```php $client->account->getAccount(); ```

$client->account->getAccountActivity($request) -> GetAccountActivityResponse

#### 📝 Description

Retrieves user activity logs from your organization for security monitoring and audit compliance. Use this to: - Monitor user login activities and access patterns - Track account modifications and configuration changes - Generate security audit reports and compliance documentation - Investigate suspicious activities and unauthorized access - Monitor team member actions and account usage Key information returned: - Complete user activity details and timestamps - User identification (email, IP address, browser) - Action types and activity descriptions - Security-relevant events and access logs - Historical activity data for audit trails Note: Requires Enterprise plan for access to organization activity logs.

#### 🔌 Usage

```php $client->account->getAccountActivity( new GetAccountActivityRequest([]), ); ```

#### ⚙️ Parameters

**$startDate:** `?string` Mandatory if endDate is used. Enter start date in UTC date (YYYY-MM-DD) format to filter the activity in your account. Maximum time period that can be selected is one month. Additionally, you can retrieve activity logs from the past 12 months from the date of your search.

**$endDate:** `?string` Mandatory if startDate is used. Enter end date in UTC date (YYYY-MM-DD) format to filter the activity in your account. Maximum time period that can be selected is one month.

**$email:** `?string` — Enter the user's email address to filter their activity in the account.

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page.

## MasterAccount

$client->masterAccount->createANewGroupOfSubAccounts($request) -> PostCorporateGroupResponse

#### 📝 Description

This endpoint allows to create a group of sub-accounts

#### 🔌 Usage

```php $client->masterAccount->createANewGroupOfSubAccounts( new PostCorporateGroupRequest([ 'groupName' => 'My group', ]), ); ```

#### ⚙️ Parameters

**$groupName:** `string` — The name of the group of sub-accounts

**$subAccountIds:** `?array` — Pass the list of sub-account Ids to be included in the group

$client->masterAccount->deleteSubAccountFromGroup($groupId, $request)

#### 📝 Description

This endpoint allows you to remove a sub-organization from a group.

#### 🔌 Usage

```php $client->masterAccount->deleteSubAccountFromGroup( 'groupId', new PutCorporateGroupUnlinkGroupIdSubAccountsRequest([ 'subAccountIds' => [ 423432, 234323, 87678, ], ]), ); ```

#### ⚙️ Parameters

**$groupId:** `string` — Group id

**$subAccountIds:** `array` — List of sub-account ids

$client->masterAccount->getAGroupDetails($id) -> GetCorporateGroupIdResponse

#### 📝 Description

This endpoint allows you to retrieve a specific group’s information such as the list of sub-organizations and the user associated with the group.

#### 🔌 Usage

```php $client->masterAccount->getAGroupDetails( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Id of the group of sub-organization

$client->masterAccount->updateAGroupOfSubAccounts($id, $request)

#### 📝 Description

This endpoint allows to update a group of sub-accounts

#### 🔌 Usage

```php $client->masterAccount->updateAGroupOfSubAccounts( 'id', new PutCorporateGroupIdRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string` — Id of the group

**$groupName:** `?string` — The name of the group of sub-accounts

**$subAccountIds:** `?array` — Pass the list of sub-account Ids to be included in the group

$client->masterAccount->deleteAGroup($id)

#### 📝 Description

This endpoint allows you to delete a group of sub-organizations. When a group is deleted, the sub-organizations are no longer part of this group. The users associated with the group are no longer associated with the group once deleted.

#### 🔌 Usage

```php $client->masterAccount->deleteAGroup( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Id of the group

$client->masterAccount->getSubAccountGroups() -> array

#### 📝 Description

This endpoint allows you to list all groups created on your Admin account.

#### 🔌 Usage

```php $client->masterAccount->getSubAccountGroups(); ```

$client->masterAccount->getCorporateInvitedUsersList($request) -> GetCorporateInvitedUsersListResponse

#### 📝 Description

This endpoint allows you to list all Admin users of your Admin account. You can filter users by type (active or pending) and paginate results using offset and limit.

#### 🔌 Usage

```php $client->masterAccount->getCorporateInvitedUsersList( new GetCorporateInvitedUsersListRequest([]), ); ```

#### ⚙️ Parameters

**$type:** `?string` User type (active | pending). This is required if offset is provided for limited result.

**$offset:** `?int` Page number for the result set. This is optional, default value will be the 1st page.

**$limit:** `?int` Number of users to be displayed on each page. This is optional, the default limit is 20, but max allowed limit is 100.

$client->masterAccount->listOfAllIPs() -> array

#### 📝 Description

This endpoint allows you to retrieve the list of active IPs on your Admin account

#### 🔌 Usage

```php $client->masterAccount->listOfAllIPs(); ```

$client->masterAccount->getTheDetailsOfRequestedMasterAccount() -> GetCorporateMasterAccountResponse

#### 📝 Description

This endpoint will provide the details of the master account.

#### 🔌 Usage

```php $client->masterAccount->getTheDetailsOfRequestedMasterAccount(); ```

$client->masterAccount->generateSsoTokenToAccessAdminAccount($request) -> GetSsoToken

#### 📝 Description

This endpoint generates an SSO token to authenticate and access the admin account using the endpoint https://account-app.brevo.com/account/login/corporate/sso/[token], where [token] will be replaced by the actual token.

#### 🔌 Usage

```php $client->masterAccount->generateSsoTokenToAccessAdminAccount( new PostCorporateSsoTokenRequest([ 'email' => 'vipin+ent-user@brevo.com', ]), ); ```

#### ⚙️ Parameters

**$email:** `string` — User email of admin account

$client->masterAccount->getTheListOfAllTheSubAccountsOfTheMasterAccount($request) -> GetCorporateSubAccountResponse

#### 📝 Description

This endpoint will provide the list all the sub-accounts of the master account.

#### 🔌 Usage

```php $client->masterAccount->getTheListOfAllTheSubAccountsOfTheMasterAccount( new GetCorporateSubAccountRequest([ 'offset' => 1, 'limit' => 1, ]), ); ```

#### ⚙️ Parameters

**$offset:** `int` — Index of the first sub-account in the page

**$limit:** `int` — Number of sub-accounts to be displayed on each page

$client->masterAccount->createANewSubAccountUnderAMasterAccount($request) -> PostCorporateSubAccountResponse

#### 📝 Description

This endpoint will create a new sub-account under a master account

#### 🔌 Usage

```php $client->masterAccount->createANewSubAccountUnderAMasterAccount( new PostCorporateSubAccountRequest([ 'companyName' => 'Test Sub-account', 'email' => 'test-sub@example.com', 'groupIds' => [ '5f8f8c3b5f56a02d4433b3a7', '5f8f8c3b5f56a02d4433b3a8', ], 'language' => PostCorporateSubAccountRequestLanguage::Fr->value, 'timezone' => 'Europe/Paris', ]), ); ```

#### ⚙️ Parameters

**$companyName:** `string` — Set the name of the sub-account company

**$email:** `string` — Email address for the organization

**$groupIds:** `?array` — Set the group(s) for the sub-account

**$language:** `?string` — Set the language of the sub-account

**$timezone:** `?string` — Set the timezone of the sub-account

$client->masterAccount->associateAnIpToSubAccounts($request) -> array

#### 📝 Description

This endpoint allows to associate an IP to sub-accounts

#### 🔌 Usage

```php $client->masterAccount->associateAnIpToSubAccounts( new PostCorporateSubAccountIpAssociateRequest([ 'ids' => [ 234322, 325553, 893432, ], 'ip' => '103.11.32.88', ]), ); ```

#### ⚙️ Parameters

**$ids:** `array` Pass the list of sub-account Ids to be associated with the IP address

**$ip:** `string` — IP address

$client->masterAccount->dissociateAnIpToSubAccounts($request)

#### 📝 Description

This endpoint allows to dissociate an IP from sub-accounts

#### 🔌 Usage

```php $client->masterAccount->dissociateAnIpToSubAccounts( new PutCorporateSubAccountIpDissociateRequest([ 'ids' => [ 234322, 325553, 893432, ], 'ip' => '103.11.32.88', ]), ); ```

#### ⚙️ Parameters

**$ids:** `array` Pass the list of sub-account Ids to be dissociated from the IP address

**$ip:** `string` — IP address

$client->masterAccount->createAnApiKeyForASubAccount($request) -> PostCorporateSubAccountKeyResponse

#### 📝 Description

This endpoint will generate an API v3 key for a sub-account

#### 🔌 Usage

```php $client->masterAccount->createAnApiKeyForASubAccount( new PostCorporateSubAccountKeyRequest([ 'id' => 3232323, 'name' => 'My Api Key', ]), ); ```

#### ⚙️ Parameters

**$id:** `int` — Id of the sub-account organization

**$name:** `string` — Name of the API key

$client->masterAccount->generateSsoTokenToAccessSubAccount($request) -> GetSsoToken

#### 📝 Description

This endpoint generates an sso token to authenticate and access a sub-account of the master using the account endpoint https://account-app.brevo.com/account/login/sub-account/sso/[token], where [token] will be replaced by the actual token.

#### 🔌 Usage

```php $client->masterAccount->generateSsoTokenToAccessSubAccount( new PostCorporateSubAccountSsoTokenRequest([ 'id' => 3232323, ]), ); ```

#### ⚙️ Parameters

**$email:** `?string` — User email of sub-account organization

**$id:** `int` — Id of the sub-account organization

**$target:** `?string` **Set target after login success** * **automation** - Redirect to Automation after login * **email_campaign** - Redirect to Email Campaign after login * **contacts** - Redirect to Contacts after login * **landing_pages** - Redirect to Landing Pages after login * **email_transactional** - Redirect to Email Transactional after login * **senders** - Redirect to Senders after login * **sms_campaign** - Redirect to Sms Campaign after login * **sms_transactional** - Redirect to Sms Transactional after login

**$url:** `?string` Set the full target URL after login success. The user will land directly on this target URL after login

$client->masterAccount->getSubAccountDetails($id) -> GetCorporateSubAccountIdResponse

#### 📝 Description

This endpoint will provide the details for the specified sub-account company

#### 🔌 Usage

```php $client->masterAccount->getSubAccountDetails( 1000000, ); ```

#### ⚙️ Parameters

**$id:** `int` — Id of the sub-account organization

$client->masterAccount->deleteASubAccount($id)

#### 🔌 Usage

```php $client->masterAccount->deleteASubAccount( 1000000, ); ```

#### ⚙️ Parameters

**$id:** `int` — Id of the sub-account organization to be deleted

$client->masterAccount->enableDisableSubAccountApplicationS($id, $request)

#### 📝 Description

API endpoint for the Corporate owner to enable/disable applications on the sub-account

#### 🔌 Usage

```php $client->masterAccount->enableDisableSubAccountApplicationS( 1000000, new PutCorporateSubAccountIdApplicationsToggleRequest([ 'landingPages' => true, 'meetings' => true, 'smsCampaigns' => false, 'webPush' => false, 'whatsapp' => true, ]), ); ```

#### ⚙️ Parameters

**$id:** `int` — Id of the sub-account organization (mandatory)

**$automation:** `?bool` Set this field to enable or disable Automation on the sub-account

**$conversations:** `?bool` Set this field to enable or disable Conversations on the sub-account

**$crm:** `?bool` — Set this field to enable or disable Sales CRM on the sub-account

**$emailCampaigns:** `?bool` Set this field to enable or disable Email Campaigns on the sub-account

**$facebookAds:** `?bool` Set this field to enable or disable Facebook ads on the sub-account

**$inbox:** `?bool` Set this field to enable or disable Inbox on the sub-account / Not applicable on ENTv2

**$landingPages:** `?bool` Set this field to enable or disable Landing pages on the sub-account

**$meetings:** `?bool` — Set this field to enable or disable Meetings on the sub-account

**$smsCampaigns:** `?bool` Set this field to enable or disable SMS Marketing on the sub-account

**$transactionalEmails:** `?bool` Set this field to enable or disable Transactional Email on the sub-account

**$transactionalSms:** `?bool` Set this field to enable or disable Transactional SMS on the sub-account

**$webPush:** `?bool` — Set this field to enable or disable Web Push on the sub-account

**$whatsapp:** `?bool` Set this field to enable or disable Whatsapp campaigns on the sub-account

$client->masterAccount->updateSubAccountPlan($id, $request)

#### 📝 Description

This endpoint will update the sub-account plan. On the Corporate solution new version v2, you can set an unlimited number of credits in your sub-organization. Please pass the value “-1" to set the consumable in unlimited mode.

#### 🔌 Usage

```php $client->masterAccount->updateSubAccountPlan( 1000000, new PutCorporateSubAccountIdPlanRequest([ 'credits' => new PutCorporateSubAccountIdPlanRequestCredits([ 'email' => 5000, 'externalFeeds' => 1, 'sms' => 2000, 'whatsapp' => 100, 'wpSubscribers' => -1, ]), 'features' => new PutCorporateSubAccountIdPlanRequestFeatures([ 'inbox' => 10, 'landingPage' => 20, 'salesUsers' => 6, 'users' => 15, ]), ]), ); ```

#### ⚙️ Parameters

**$id:** `int` — Id of the sub-account organization

**$credits:** `?PutCorporateSubAccountIdPlanRequestCredits` — Credit details to update

**$features:** `?PutCorporateSubAccountIdPlanRequestFeatures` — Features details to update

$client->masterAccount->updateSubAccountsPlan($request)

#### 📝 Description

This endpoint will update multiple sub-accounts plan. On the Corporate solution new version v2, you can set an unlimited number of credits in your sub-organization. Please pass the value “-1" to set the consumable in unlimited mode.

#### 🔌 Usage

```php $client->masterAccount->updateSubAccountsPlan( new PutCorporateSubAccountsPlanRequest([ 'credits' => new PutCorporateSubAccountsPlanRequestCredits([ 'email' => 5000, 'externalFeeds' => 1, 'sms' => 2000, 'whatsapp' => 100, 'wpSubscribers' => -1, ]), 'features' => new PutCorporateSubAccountsPlanRequestFeatures([ 'landingPage' => 20, 'salesUsers' => 6, 'users' => 15, ]), 'subAccountIds' => [ 4534345, 987893, 876785, ], ]), ); ```

#### ⚙️ Parameters

**$credits:** `?PutCorporateSubAccountsPlanRequestCredits` — Credit details to update

**$features:** `?PutCorporateSubAccountsPlanRequestFeatures` — Features details to update

**$subAccountIds:** `?array` — List of sub-account ids

$client->masterAccount->inviteAdminUser($request) -> InviteAdminUserResponse

#### 📝 Description

`This endpoint allows you to invite a member to manage the Admin account Features and their respective permissions are as below: - `my_plan`: - "all" - `api`: - "none" - `user_management`: - "all" - `app_management` | Not available in ENTv2: - "all" - `sub_organization_groups` - "create" - "edit_delete" - `create_sub_organizations` - "all" - `manage_sub_organizations` - "all" - `analytics` - "download_data" - "create_alerts" - "my_looks" - "explore_create" - `security` - "all" **Note**: - If `all_features_access: false` then only privileges are required otherwise if `true` then it's assumed that all permissions will be there for the invited admin user.

#### 🔌 Usage

```php $client->masterAccount->inviteAdminUser( new InviteAdminUserRequest([ 'allFeaturesAccess' => true, 'email' => 'inviteuser@example.com', 'privileges' => [ new InviteAdminUserRequestPrivilegesItem([]), ], ]), ); ```

#### ⚙️ Parameters

**$allFeaturesAccess:** `bool` — All access to the features

**$email:** `string` — Email address for the organization

**$groupIds:** `?array` — Ids of Group

**$privileges:** `array`

$client->masterAccount->resendCancelAdminUserInvitation($action, $email) -> PutCorporateUserInvitationActionEmailResponse

#### 📝 Description

This endpoint will allow the user to: - Resend an admin user invitation - Cancel an admin user invitation

#### 🔌 Usage

```php $client->masterAccount->resendCancelAdminUserInvitation( PutCorporateUserInvitationActionEmailRequestAction::Resend->value, 'email', ); ```

#### ⚙️ Parameters

**$action:** `string` — Action to be performed (cancel / resend)

**$email:** `string` — Email address of the recipient

$client->masterAccount->revokeAnAdminUser($email)

#### 📝 Description

This endpoint allows to revoke/remove an invited member of your Admin account

#### 🔌 Usage

```php $client->masterAccount->revokeAnAdminUser( 'email', ); ```

#### ⚙️ Parameters

**$email:** `string` — Email of the invited user

$client->masterAccount->getCorporateUserPermission($email) -> GetCorporateUserPermissionResponse

#### 📝 Description

This endpoint will provide the list of admin user permissions

#### 🔌 Usage

```php $client->masterAccount->getCorporateUserPermission( 'email', ); ```

#### ⚙️ Parameters

**$email:** `string` — Email of the invited user.

$client->masterAccount->changeAdminUserPermissions($email, $request)

#### 📝 Description

This endpoint will allow you to change the permissions of Admin users of your Admin account

#### 🔌 Usage

```php $client->masterAccount->changeAdminUserPermissions( 'email', new PutCorporateUserEmailPermissionsRequest([ 'allFeaturesAccess' => false, 'privileges' => [ new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::UserManagement->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::All->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::Api->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::All->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::MyPlan->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::None->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::AppsManagement->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::All->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::CreateSubOrganizations->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::All->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::SubOrganizationGroups->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::Create->value, PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::EditDelete->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::ManageSubOrganizations->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::All->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::Security->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::None->value, ], ]), new PutCorporateUserEmailPermissionsRequestPrivilegesItem([ 'feature' => PutCorporateUserEmailPermissionsRequestPrivilegesItemFeature::Analytics->value, 'permissions' => [ PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::CreateAlerts->value, PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::DownloadData->value, PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::MyLooks->value, PutCorporateUserEmailPermissionsRequestPrivilegesItemPermissionsItem::ExploreCreate->value, ], ]), ], ]), ); ```

#### ⚙️ Parameters

**$email:** `string` — Email address of Admin user

**$allFeaturesAccess:** `bool` — All access to the features

**$privileges:** `array`

## User

$client->user->getInvitedUsersList() -> GetInvitedUsersListResponse

#### 🔌 Usage

```php $client->user->getInvitedUsersList(); ```

$client->user->putRevokeUserPermission($email) -> PutRevokeUserPermissionResponse

#### 🔌 Usage

```php $client->user->putRevokeUserPermission( 'email', ); ```

#### ⚙️ Parameters

**$email:** `string` — Email of the invited user.

$client->user->inviteuser($request) -> InviteuserResponse

#### 📝 Description

`Feature` - A Feature represents a specific functionality like Email campaign, Deals, Calls, Automations, etc. on Brevo. While inviting a user, determine which feature you want to manage access to. You must specify the feature accurately to avoid errors. `Permission` - A Permission defines the level of access or control a user has over a specific feature. While inviting user, decide on the permission level required for the selected feature. Make sure the chosen permission is related to the selected feature. Features and their respective permissions are as below: - `email_campaigns`: - "create_edit_delete" - "send_schedule_suspend" - `sms_campaigns`: - "create_edit_delete" - "send_schedule_suspend" - `contacts`: - "view" - "create_edit_delete" - "import" - "export" - "list_and_attributes" - "forms" - `templates`: - "create_edit_delete" - "activate_deactivate" - `workflows`: - "create_edit_delete" - "activate_deactivate_pause" - "settings" - `landing_pages`: - "all" - `transactional_emails`: - "settings" - "logs" - `smtp_api`: - "smtp" - "api_keys" - "authorized_ips" - `user_management`: - "all" - `sales_platform`: - "create_edit_deals" - "delete_deals" - "manage_others_deals_tasks" - "reports" - "settings" - `phone`: - "all" - `conversations`: - "access" - "assign" - "configure" - `senders_domains_dedicated_ips`: - "senders_management" - "domains_management" - "dedicated_ips_management" - `push_notifications`: - "view" - "create_edit_delete" - "send" - "settings" - `companies`: - "manage_owned_companies" - "manage_other_companies" - "settings" **Note**: - If `all_features_access: false` then only privileges are required otherwise if `true` then it's assumed that all permissions will be there for the invited user. - The availability of feature and its permission depends on your current plan. Please select the features and permissions accordingly.

#### 🔌 Usage

```php $client->user->inviteuser( new Inviteuser([ 'allFeaturesAccess' => true, 'email' => 'inviteuser@example.com', 'privileges' => [ new InviteuserPrivilegesItem([]), ], ]), ); ```

#### ⚙️ Parameters

**$request:** `Inviteuser`

$client->user->putresendcancelinvitation($action, $email) -> PutresendcancelinvitationResponse

#### 🔌 Usage

```php $client->user->putresendcancelinvitation( PutresendcancelinvitationRequestAction::Resend->value, 'email', ); ```

#### ⚙️ Parameters

**$action:** `string` — action

**$email:** `string` — Email of the invited user.

$client->user->editUserPermission($request) -> EditUserPermissionResponse

#### 📝 Description

`Feature` - A Feature represents a specific functionality like Email campaign, Deals, Calls, Automations, etc. on Brevo. While inviting a user, determine which feature you want to manage access to. You must specify the feature accurately to avoid errors. `Permission` - A Permission defines the level of access or control a user has over a specific feature. While inviting user, decide on the permission level required for the selected feature. Make sure the chosen permission is related to the selected feature. Features and their respective permissions are as below: - `email_campaigns`: - "create_edit_delete" - "send_schedule_suspend" - `sms_campaigns`: - "create_edit_delete" - "send_schedule_suspend" - `contacts`: - "view" - "create_edit_delete" - "import" - "export" - "list_and_attributes" - "forms" - `templates`: - "create_edit_delete" - "activate_deactivate" - `workflows`: - "create_edit_delete" - "activate_deactivate_pause" - "settings" - `landing_pages`: - "all" - `transactional_emails`: - "settings" - "logs" - `smtp_api`: - "smtp" - "api_keys" - "authorized_ips" - `user_management`: - "all" - `sales_platform`: - "create_edit_deals" - "delete_deals" - "manage_others_deals_tasks" - "reports" - "settings" - `phone`: - "all" - `conversations`: - "access" - "assign" - "configure" - `senders_domains_dedicated_ips`: - "senders_management" - "domains_management" - "dedicated_ips_management" - `push_notifications`: - "view" - "create_edit_delete" - "send" - "settings" - `companies`: - "manage_owned_companies" - "manage_other_companies" - "settings" **Note**: - The privileges array remains the same as in the send invitation; the user simply needs to provide the permissions that need to be updated. - The availability of feature and its permission depends on your current plan. Please select the features and permissions accordingly.

#### 🔌 Usage

```php $client->user->editUserPermission( new Inviteuser([ 'allFeaturesAccess' => true, 'email' => 'inviteuser@example.com', 'privileges' => [ new InviteuserPrivilegesItem([]), ], ]), ); ```

#### ⚙️ Parameters

**$request:** `Inviteuser`

$client->user->getUserPermission($email) -> GetUserPermissionResponse

#### 🔌 Usage

```php $client->user->getUserPermission( 'email', ); ```

#### ⚙️ Parameters

**$email:** `string` — Email of the invited user.

## Process

$client->process->getProcesses($request) -> GetProcessesResponse

#### 📝 Description

Retrieves a list of background processes from your Brevo account with filtering and pagination. **Use this to:** - Monitor background process activity and status - Track long-running operations and tasks - Find process IDs for detailed status checking - Review process history and performance - Identify failed or stuck processes for troubleshooting **Key information returned:** - Process details (ID, name, type, status) - Process creation and completion timestamps - Process progress and completion status - Error information for failed processes - Process result data and download links **Important considerations:** - Background processes handle long-running operations like imports and exports - Process status indicates current state (queued, processing, completed, failed, cancelled) - Export processes provide download URLs when completed - Failed processes include error messages for troubleshooting - Use pagination for accounts with many historical processes - Sort options available for creation order (ascending or descending) - Different process types handle specific operations (imports, exports, calculations)

#### 🔌 Usage

```php $client->process->getProcesses( new GetProcessesRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number limitation for the result returned

**$offset:** `?int` — Beginning point in the list to retrieve from.

**$sort:** `?string` Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->process->getProcess($processId) -> GetProcessResponse

#### 📝 Description

Retrieves detailed information about a specific background process. **Use this to:** - Get detailed status of a specific process - Monitor process progress and completion - Download results from completed export processes - Check error details for failed processes - Track process execution times **Key information returned:** - Complete process details and status - Import/export statistics and results - Error information for troubleshooting - Download URLs for export processes - Process timing and performance data **Important considerations:** - Process ID must exist in your account - Completed processes provide detailed statistics and results - Export processes include download URLs when successful - Failed processes contain error messages for debugging - Timing information helps with performance analysis - Different process types return different result structures

#### 🔌 Usage

```php $client->process->getProcess( 1000000, ); ```

#### ⚙️ Parameters

**$processId:** `int` — Id of the process

## Senders

$client->senders->getSenders($request) -> GetSendersResponse

#### 📝 Description

Retrieves a list of all email senders from your Brevo account with optional filtering. **Use this to:** - Get all available senders for email campaign setup - Find sender details including ID, name, and email address - Filter senders by IP address for dedicated IP users - Filter senders by domain for domain-specific configurations - Monitor sender configuration and status **Key information returned:** - Sender details (ID, name, email address) - Sender status and verification information - Associated IP addresses and domains (for dedicated IP accounts) - Sender configuration settings **Important considerations:** - Standard accounts show empty IP arrays, dedicated IP accounts show IP assignments - Filtering by IP only available for accounts with dedicated IPs - Domain filtering helps organize senders by business units or brands - Sender status indicates if sender is active and ready for campaign use - Email verification required before sender can be used in campaigns

#### 🔌 Usage

```php $client->senders->getSenders( new GetSendersRequest([]), ); ```

#### ⚙️ Parameters

**$ip:** `?string` — Filter your senders for a specific ip. **Available for dedicated IP usage only**

**$domain:** `?string` — Filter your senders for a specific domain

$client->senders->createSender($request) -> CreateSenderResponse

#### 📝 Description

Creates a new email sender in your Brevo account. **Use this to:** - Add new senders for email campaigns - Configure sender identity (name and email) - Associate dedicated IPs with the sender (for dedicated IP accounts) - Set up domain-based sender configurations **Key information returned:** - Created sender ID - DKIM and SPF configuration status - Success confirmation **Important considerations:** - Verification email sent to specified sender address - DKIM and SPF configuration affects deliverability - Dedicated IP accounts require IP association during creation - IP weights must sum to 100 when specified - Sender must be verified before use in campaigns

#### 🔌 Usage

```php $client->senders->createSender( new CreateSenderRequest([ 'email' => 'support@example.com', 'name' => 'Support Team', ]), ); ```

#### ⚙️ Parameters

**$email:** `string` From email to use for the sender. A verification email will be sent to this address.

**$ips:** `?array` **Mandatory in case of dedicated IP**. IPs to associate to the sender. Not required for standard accounts.

**$name:** `string` — From Name to use for the sender

$client->senders->getIps() -> GetIpsResponse

#### 📝 Description

Retrieves all dedicated IPs associated with your Brevo account. Use this to: - List all your dedicated IPs - Check the status of your dedicated IPs (active/inactive) - Find IP addresses and associated domains for configuration purposes - Monitor your IP reputation and deliverability - Verify available IPs for sender configuration Key information returned: - IP ID and address - Associated domain - Active status - IP configuration details

#### 🔌 Usage

```php $client->senders->getIps(); ```

$client->senders->updateSender($senderId, $request)

#### 📝 Description

Updates an existing email sender's configuration. Use this to: - Modify sender display name or email address - Update dedicated IP associations - Change sender configuration settings - Correct sender information Key information returned: - Success confirmation - Updated sender details

#### 🔌 Usage

```php $client->senders->updateSender( 1000000, new UpdateSenderRequest([ 'name' => 'New Support Team', ]), ); ```

#### ⚙️ Parameters

**$senderId:** `int` — Id of the sender

**$email:** `?string` — From Email to update the sender

**$ips:** `?array` **Only in case of dedicated IP**. IPs to associate to the sender. If passed, will replace all the existing IPs. Not required for standard accounts.

**$name:** `?string` — From Name to update the sender

$client->senders->deleteSender($senderId)

#### 📝 Description

Deletes an email sender from your Brevo account. Use this to: - Remove senders that are no longer needed - Clean up sender configurations - Remove duplicate or test senders Key information returned: - Success confirmation message

#### 🔌 Usage

```php $client->senders->deleteSender( 1000000, ); ```

#### ⚙️ Parameters

**$senderId:** `int` — Id of the sender

$client->senders->getIpsFromSender($senderId) -> GetIpsFromSenderResponse

#### 📝 Description

Retrieves the dedicated IPs associated with a specific sender. Use this to: - Check IP configuration for a sender - Verify dedicated IP associations - Get IP details for troubleshooting - Monitor sender IP configuration Key information returned: - List of associated dedicated IPs - IP addresses and domain configurations - IP status and settings

#### 🔌 Usage

```php $client->senders->getIpsFromSender( 1000000, ); ```

#### ⚙️ Parameters

**$senderId:** `int` — Id of the sender

$client->senders->validateSenderByOtp($senderId, $request)

#### 📝 Description

Validates a sender using the OTP (One-Time Password) received via email. Use this to: - Complete sender verification process - Activate a newly created sender - Verify ownership of the sender email address - Enable the sender for use in email campaigns Key information returned: - Success confirmation of sender verification - Sender activation status

#### 🔌 Usage

```php $client->senders->validateSenderByOtp( 1000000, new ValidateSenderByOtpRequest([ 'otp' => 123456, ]), ); ```

#### ⚙️ Parameters

**$senderId:** `int` — Id of the sender

**$otp:** `int` — 6 digit OTP received on email

## Domains

$client->domains->getDomains() -> GetDomainsResponse

#### 📝 Description

Retrieves all domains associated with the account. Use this to: - List all domains - Verify domain existence - Check domain authentication and verification status - Monitor domain configuration and provider information - Review domain creation history and ownership Key information returned: - Domain details (ID, name, authentication status) - Verification and authentication states - Associated IP addresses and DNS providers - Creator information and creation timestamps - Pagination information for large domain lists

#### 🔌 Usage

```php $client->domains->getDomains(); ```

$client->domains->createDomain($request) -> CreateDomainResponse

#### 📝 Description

Creates a new domain in Brevo. Use this to: - Add new domains for sending emails - Set up domain authentication for better deliverability - Configure DNS records for email authentication - Establish domain-based sender identities Key information returned: - Created domain ID and configuration - Required DNS records for authentication - Domain provider detection results - Setup instructions and next steps

#### 🔌 Usage

```php $client->domains->createDomain( new CreateDomainRequest([ 'name' => 'mycompany.com', ]), ); ```

#### ⚙️ Parameters

**$name:** `string` — Domain name to be added

$client->domains->getDomainConfiguration($domainName) -> GetDomainConfigurationResponse

#### 📝 Description

Retrieves configuration of a specific domain, to know if the domain is valid or not. Use this to: - Check domain configuration - Validate a domain configuration - Monitor DNS record status - Troubleshoot authentication issues Key information returned: - Domain verification and authentication status - DNS records configuration and validation status - Detailed authentication requirements

#### 🔌 Usage

```php $client->domains->getDomainConfiguration( 'domainName', ); ```

#### ⚙️ Parameters

**$domainName:** `string` — Domain name

$client->domains->deleteDomain($domainName)

#### 📝 Description

Deletes a domain from Brevo. Use this to: - Remove existing domains - Clean up unused domain configurations - Remove test domains Key information returned: - Success confirmation message

#### 🔌 Usage

```php $client->domains->deleteDomain( 'domainName', ); ```

#### ⚙️ Parameters

**$domainName:** `string` — Domain name

$client->domains->authenticateDomain($domainName) -> AuthenticateDomainResponse

#### 📝 Description

Authenticates a specific domain. Use this to: - Authenticate a domain - Verify DNS record configuration - Complete domain setup for sending - Enable domain for email authentication Key information returned: - Authentication success confirmation - Domain readiness status for email sending

#### 🔌 Usage

```php $client->domains->authenticateDomain( 'domainName', ); ```

#### ⚙️ Parameters

**$domainName:** `string` — Domain name

## Webhooks

$client->webhooks->getWebhooks($request) -> GetWebhooksResponse

#### 📝 Description

Retrieves all webhooks from your Brevo account with filtering and sorting options. Use this to: - Monitor webhook configurations and event handling - List webhooks by type (transactional, marketing, inbound) - Review webhook endpoints and authentication - Track webhook creation and modification history - Audit webhook event subscriptions Key information returned: - Complete webhook details and configuration - Event types and channel subscriptions - Authentication and security settings - Webhook URLs and custom headers - Creation and modification timestamps

#### 🔌 Usage

```php $client->webhooks->getWebhooks( new GetWebhooksRequest([]), ); ```

#### ⚙️ Parameters

**$type:** `?string` — Filter on webhook type

**$sort:** `?string` — Sort the results in the ascending/descending order of webhook creation

$client->webhooks->createWebhook($request) -> CreateWebhookResponse

#### 📝 Description

Creates a new webhook to receive real-time notifications for specified events. Use this to: - Set up event notifications for transactional or marketing emails - Configure webhook endpoints for campaign tracking - Enable real-time monitoring of email delivery status - Subscribe to contact list changes and updates - Implement custom event handling and automation Key information returned: - Created webhook ID and configuration - Success confirmation and setup details

#### 🔌 Usage

```php $client->webhooks->createWebhook( new CreateWebhookRequest([ 'events' => [ CreateWebhookRequestEventsItem::Sent->value, ], 'url' => 'http://requestb.in/173lyyx1', ]), ); ```

#### ⚙️ Parameters

**$auth:** `?CreateWebhookRequestAuth` — Add authentication on webhook url

**$batched:** `?bool` — To send batched webhooks

**$channel:** `?string` — channel of webhook

**$description:** `?string` — Description of the webhook

**$domain:** `?string` Inbound domain of webhook, required in case of event type `inbound`

**$events:** `array` - Events triggering the webhook. Possible values for **Transactional** type webhook: #### `sent` OR `request`, `delivered`, `hardBounce`, `softBounce`, `blocked`, `spam`, `invalid`, `deferred`, `click`, `opened`, `uniqueOpened` and `unsubscribed` - Possible values for **Marketing** type webhook: #### `spam`, `opened`, `click`, `hardBounce`, `softBounce`, `unsubscribed`, `listAddition` & `delivered` - Possible values for **Inbound** type webhook: #### `inboundEmailProcessed` - Possible values for type **Transactional** and channel **SMS** #### `accepted`,`delivered`,`softBounce`,`hardBounce`,`unsubscribe`,`reply`, `subscribe`,`sent`,`blacklisted`,`skip` - Possible values for type **Marketing** channel **SMS** #### `sent`,`delivered`,`softBounce`,`hardBounce`,`unsubscribe`,`reply`, `subscribe`,`skip`

**$headers:** `?array` — Custom headers to be send with webhooks

**$type:** `?string` — Type of the webhook

**$url:** `string` — URL of the webhook

$client->webhooks->exportWebhooksHistory($request) -> ExportWebhooksHistoryResponse

#### 📝 Description

This is an enterprise feature. To have it activated please send us a request and we will activate it for your account. Exports webhook event history to CSV format for analysis and reporting. Use this to: - Generate comprehensive webhook event reports - Analyze webhook delivery patterns and success rates - Export event data for external analysis tools - Create historical reports for compliance and auditing - Track webhook performance and reliability metrics Key information returned: - Process ID for tracking export completion - CSV file will be delivered to specified webhook URL

#### 🔌 Usage

```php $client->webhooks->exportWebhooksHistory( new ExportWebhooksHistoryRequest([ 'event' => ExportWebhooksHistoryRequestEvent::InvalidParameter->value, 'notifyUrl' => 'https://brevo.com', 'type' => ExportWebhooksHistoryRequestType::Transactional->value, ]), ); ```

#### ⚙️ Parameters

**$days:** `?int` Number of days in the past including today (positive integer). _Not compatible with 'startDate' and 'endDate'_

**$email:** `?string` — Filter the history for a specific email

**$endDate:** `?string` Mandatory if startDate is used. Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate

**$event:** `string` — Filter the history for a specific event type

**$messageId:** `?int` Filter the history for a specific message id. Applicable only for transactional webhooks.

**$notifyUrl:** `string` — Webhook URL to receive CSV file link

**$sort:** `?string` — Sorting order of records (asc or desc)

**$startDate:** `?string` Mandatory if endDate is used. Starting date of the history (YYYY-MM-DD). Must be lower than equal to endDate

**$type:** `string` — Filter the history based on webhook type

**$webhookId:** `?int` — Filter the history for a specific webhook id

$client->webhooks->getWebhook($webhookId) -> GetWebhook

#### 📝 Description

Retrieves detailed information about a specific webhook configuration. Use this to: - Get complete webhook configuration and settings - Check webhook event subscriptions and triggers - Review authentication and security settings - Verify webhook URL and custom headers - Access webhook creation and modification history Key information returned: - Complete webhook details and configuration - Event types and channel subscriptions - Authentication credentials and methods - Custom headers and request settings - Webhook status and activity information

#### 🔌 Usage

```php $client->webhooks->getWebhook( 1000000, ); ```

#### ⚙️ Parameters

**$webhookId:** `int` — Id of the webhook

$client->webhooks->updateWebhook($webhookId, $request)

#### 📝 Description

Updates an existing webhook configuration and event subscriptions. Use this to: - Modify webhook event subscriptions and triggers - Update webhook URL and endpoint configuration - Change authentication settings and credentials - Adjust custom headers and request parameters - Enable or disable specific webhook events Key information returned: - Success confirmation of webhook updates

#### 🔌 Usage

```php $client->webhooks->updateWebhook( 1000000, new UpdateWebhookRequest([]), ); ```

#### ⚙️ Parameters

**$webhookId:** `int` — Id of the webhook

**$auth:** `?UpdateWebhookRequestAuth` — Add authentication on webhook url

**$batched:** `?bool` — To send batched webhooks

**$description:** `?string` — Description of the webhook

**$domain:** `?string` — Inbound domain of webhook, used in case of event type `inbound`

**$events:** `?array` - Events triggering the webhook. Possible values for **Transactional** type webhook: #### `sent` OR `request`, `delivered`, `hardBounce`, `softBounce`, `blocked`, `spam`, `invalid`, `deferred`, `click`, `opened`, `uniqueOpened` and `unsubscribed` - Possible values for **Marketing** type webhook: #### `spam`, `opened`, `click`, `hardBounce`, `softBounce`, `unsubscribed`, `listAddition` & `delivered` - Possible values for **Inbound** type webhook: #### `inboundEmailProcessed` #### `reply`

**$headers:** `?array` — Custom headers to be send with webhooks

**$url:** `?string` — URL of the webhook

$client->webhooks->deleteWebhook($webhookId)

#### 📝 Description

Permanently deletes a webhook and stops all event notifications. Use this to: - Remove unused or obsolete webhook configurations - Clean up webhook endpoints and subscriptions - Stop event notifications to specific URLs - Maintain organized webhook management Key information returned: - Success confirmation of webhook deletion

#### 🔌 Usage

```php $client->webhooks->deleteWebhook( 1000000, ); ```

#### ⚙️ Parameters

**$webhookId:** `int` — Id of the webhook

## ExternalFeeds

$client->externalFeeds->getAllExternalFeeds($request) -> GetAllExternalFeedsResponse

#### 📝 Description

Retrieves all external feeds from your Brevo account with filtering and pagination. **Use this to:** - Get an overview of all external data feeds - Find feeds by name using search functionality - Filter feeds by creation date range - Browse feeds by authentication type - Monitor feed library organization and usage **Key information returned:** - Feed details (UUID, name, URL, authentication type) - Feed configuration and settings - Creation and modification timestamps - Feed status and error information - Authentication and header configurations **Important considerations:** - External feeds enable dynamic content in email campaigns - Feeds must be accessible from Brevo servers - Authentication credentials are securely stored - Feed performance affects campaign delivery - Use pagination for accounts with many feeds - Date range filtering limited to 30 days maximum - Search functionality works on feed name matching - Internal feeds are system-managed and cannot be modified

#### 🔌 Usage

```php $client->externalFeeds->getAllExternalFeeds( new GetAllExternalFeedsRequest([ 'search' => 'product', 'startDate' => new DateTime('2024-01-01'), 'endDate' => new DateTime('2024-01-31'), ]), ); ```

#### ⚙️ Parameters

**$search:** `?string` — Can be used to filter records by search keyword on feed name

**$startDate:** `?DateTime` Mandatory if `endDate` is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Can be maximum 30 days older than current date.

**$endDate:** `?DateTime` Mandatory if `startDate` is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month.

**$sort:** `?string` Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed.

**$authType:** `?string` — Filter the records by `authType` of the feed.

**$limit:** `?int` — Number of documents returned per page.

**$offset:** `?int` — Index of the first document on the page.

$client->externalFeeds->createExternalFeed($request) -> CreateExternalFeedResponse

#### 📝 Description

Creates a new external feed for dynamic content in email campaigns. **Use this to:** - Set up external data sources for dynamic content - Configure authentication for protected feeds - Enable real-time content updates in campaigns - Establish connections to product catalogs, blogs, or APIs **Key information returned:** - Created feed UUID for reference in campaigns - Success confirmation **Important considerations:** - Feed URL must be accessible from Brevo infrastructure - Authentication credentials are securely encrypted - Test feed accessibility before campaign use - Consider feed response time for campaign performance - Monitor feed reliability and uptime - Use caching for frequently accessed feeds - Maximum 5 retry attempts allowed for failed requests - Custom headers support for API integration requirements

#### 🔌 Usage

```php $client->externalFeeds->createExternalFeed( new CreateExternalFeedRequest([ 'name' => 'Public API Feed', 'url' => 'https://jsonplaceholder.typicode.com/posts', 'authType' => CreateExternalFeedRequestAuthType::NoAuth->value, 'maxRetries' => 3, 'cache' => true, ]), ); ```

#### ⚙️ Parameters

**$name:** `string` — Name of the feed

**$url:** `string` — URL of the external data source

**$authType:** `?string` — Authentication type for accessing the feed

**$username:** `?string` — Username for basic authentication (required if authType is 'basic')

**$password:** `?string` — Password for basic authentication (required if authType is 'basic')

**$token:** `?string` — Token for token-based authentication (required if authType is 'token')

**$maxRetries:** `?int` — Maximum number of retry attempts for failed requests

**$cache:** `?bool` — Whether to cache the feed response

**$headers:** `?array` — Custom HTTP headers for the feed request

$client->externalFeeds->getExternalFeedByUuid($uuid) -> GetExternalFeedByUuidResponse

#### 📝 Description

Retrieves details of a specific external feed by its UUID. **Use this to:** - Get complete configuration of an external feed - Check feed authentication settings - Review feed personalization options - Verify feed URL and parameters - Monitor feed modification history **Key information returned:** - Complete feed configuration and settings - Authentication credentials and headers - Personalization and fallback settings - Creation and modification timestamps - Cache and retry configurations **Important considerations:** - UUID must exist in your account - Provides complete feed information for troubleshooting - Essential before making modifications - Shows current feed health status - Useful for debugging feed issues

#### 🔌 Usage

```php $client->externalFeeds->getExternalFeedByUuid( 'b1c2d3e4-f5a6-47b8-89c0-d1e2f3a4b5c6', ); ```

#### ⚙️ Parameters

**$uuid:** `string` — UUID of the feed to fetch

$client->externalFeeds->updateExternalFeed($uuid, $request)

#### 📝 Description

Updates configuration of an existing external feed. **Use this to:** - Update feed URLs when data sources change - Modify authentication credentials - Change cache and retry settings - Update custom headers - Rename feeds for better organization **Key information returned:** - Success confirmation message **Important considerations:** - Only provided fields will be updated - Feed UUID must exist in your account - Authentication changes require verification - URL changes should be tested before campaign use - Monitor campaigns using this feed after updates

#### 🔌 Usage

```php $client->externalFeeds->updateExternalFeed( 'b1c2d3e4-f5a6-47b8-89c0-d1e2f3a4b5c6', new UpdateExternalFeedRequest([ 'name' => 'Updated Product Catalog', 'url' => 'https://api.newstore.com/products/v2', ]), ); ```

#### ⚙️ Parameters

**$uuid:** `string` — UUID of the feed to update

**$name:** `?string` — Name of the feed

**$url:** `?string` — URL of the external data source

**$authType:** `?string` — Authentication type for accessing the feed

**$username:** `?string` — Username for basic authentication

**$password:** `?string` — Password for basic authentication

**$token:** `?string` — Token for token-based authentication

**$headers:** `?array` — Custom HTTP headers for the feed request

**$maxRetries:** `?int` — Maximum number of retry attempts for failed requests

**$cache:** `?bool` — Whether to cache the feed response

$client->externalFeeds->deleteExternalFeed($uuid)

#### 📝 Description

Deletes an external feed from your Brevo account. **Use this to:** - Remove external feeds that are no longer needed - Clean up unused data sources - Remove test or outdated feeds - Maintain organized feed library **Key information returned:** - Success confirmation message **Important considerations:** - This action is PERMANENT and cannot be undone - Feed configuration and history will be lost - Check if feed is used in active campaigns before deletion - Remove feed references from email templates - Consider deactivating instead of deleting if unsure

#### 🔌 Usage

```php $client->externalFeeds->deleteExternalFeed( 'b1c2d3e4-f5a6-47b8-89c0-d1e2f3a4b5c6', ); ```

#### ⚙️ Parameters

**$uuid:** `string` — UUID of the feed to delete

## CustomObjects

$client->customObjects->upsertrecords($objectType, $request) -> UpsertrecordsResponse

#### 📝 Description

Custom objects are only available to Enterprise plans. This feature is in beta. These are subject to change. This API allows bulk upsert of object records in a single request. Each object record may include - Attributes - Identifiers - Associations **Response:** The API processes the request asynchronously and returns a processId that you can use to track the background process status. **API and Schema Limitation:** - Size: - Max 1000 objects records per request - Max request body size: 1 MB - Max 500 attributes defined per object record upsert request - This is coherent with schema limitation: an object cannot have more than 500 attributes. - Worth noting: Nothing happens If an attribute is mentioned in the request, but was not previously defined for the object schema (no error, no attribute creation) - Max 10 associations defined per associated object type, in each record of the request - This is not a schema limitation. You can associate an object record to an unlimited number of other object records by running multiple requests. **Errors:** - Make sure both object records exist before associating them, else the API will return an error. - This route does not create objects. The object where the object records are upserted by this API must be created already else the API will return an error "invalid object type".

#### 🔌 Usage

```php $client->customObjects->upsertrecords( 'vehicle', new UpsertrecordsRequest([ 'records' => [ new UpsertrecordsRequestRecordsItem([]), ], ]), ); ```

#### ⚙️ Parameters

**$objectType:** `string` — object type for the attribute

**$records:** `array` — List of object records to be upsert. Each record can have attributes, identifiers, and associations.

$client->customObjects->getrecords($objectType, $request) -> GetrecordsResponse

#### 📝 Description

Custom objects are only available to Enterprise plans. This feature is in beta. These are subject to change. This API retrieves a list of object records along with their associated records and provides the total count of records for the specified object. **Note**: Contact as object type is not supported in this endpoint.

#### 🔌 Usage

```php $client->customObjects->getrecords( 'vehicle', new GetrecordsRequest([ 'limit' => 1000000, 'pageNum' => 1000000, ]), ); ```

#### ⚙️ Parameters

**$objectType:** `string` — object type for the attribute

**$limit:** `int` — Number of records returned per page

**$pageNum:** `int` — Page number for pagination. It's used to fetch the object records on a provided page number. Must be a valid positive integer.

**$sort:** `?string` — Sort order, must be 'asc' or 'desc'. Default to 'desc' if not provided.

**$association:** `?string` — Whether to include associations, must be 'true' or 'false'. Default to 'false' if not provided.

$client->customObjects->batchDeleteObjectRecords($objectType, $request) -> BatchDeleteObjectRecordsResponse

#### 📝 Description

Use this endpoint to delete multiple object records of the same object-type in one request. The request is accepted and processed asynchronously. You can track the status of the deletion process using the returned **processId**. **API and Schema Limitations:** - Each request can contain up to **1000** object record identifiers - If more records must be deleted → send multiple batch requests

#### 🔌 Usage

```php $client->customObjects->batchDeleteObjectRecords( 'vehicle', new BatchDeleteObjectRecordsRequest([ 'identifiers' => new BatchDeleteObjectRecordsRequestIdentifiersIds([ 'ids' => [ 1, ], ]), ]), ); ```

#### ⚙️ Parameters

**$objectType:** `string` — Object type for the records to delete

**$identifiers:** `BatchDeleteObjectRecordsRequestIdentifiersIds|BatchDeleteObjectRecordsRequestIdentifiersExtIds|null` — One of the below must be provided

## Contacts

$client->contacts->getContacts($request) -> GetContacts

#### 🔌 Usage

```php $client->contacts->getContacts( new GetContactsRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document of the page

**$modifiedSince:** `?string` — Filter (urlencoded) the contacts modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

**$createdSince:** `?string` — Filter (urlencoded) the contacts created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

**$segmentId:** `?int` — Id of the segment. **Either listIds or segmentId can be passed.**

**$listIds:** `?int` — Ids of the list. **Either listIds or segmentId can be passed.**

**$filter:** `?string` — Filter the contacts on the basis of attributes. **Allowed operator: equals. For multiple-choice options, the filter will apply an AND condition between the options. For category attributes, the filter will work with both id and value. (e.g. filter=equals(FIRSTNAME,"Antoine"), filter=equals(B1, true), filter=equals(DOB, "1989-11-23"), filter=equals(GENDER, "1"), filter=equals(GENDER, "MALE"), filter=equals(COUNTRY,"USA, INDIA")**

$client->contacts->createContact($request) -> CreateContactResponse

#### 📝 Description

Follow this format when passing a "SMS" phone number as an attribute. Accepted Number Formats 91xxxxxxxxxx +91xxxxxxxxxx 0091xxxxxxxxxx Creates new contacts on Brevo. Contacts can be created by passing either -

1. email address of the contact (email_id),
2. phone number of the contact (to be passed as "SMS" field in "attributes" along with proper country code), For example- {"SMS":"+91xxxxxxxxxx"} or {"SMS":"0091xxxxxxxxxx"}
3. ext_id

#### 🔌 Usage

```php $client->contacts->createContact( new CreateContactRequest([]), ); ```

#### ⚙️ Parameters

**$attributes:** `?array` — Pass the set of attributes and their values. The attribute's parameter should be passed in capital letter while creating a contact. Values that don't match the attribute type (e.g. text or string in a date attribute) will be ignored. **These attributes must be present in your Brevo account**. For eg: **{"FNAME":"Elly", "LNAME":"Roger", "COUNTRIES": ["India","China"]}**

**$email:** `?string` — Email address of the user. **Mandatory if "ext_id" & "SMS" field is not passed.**

**$emailBlacklisted:** `?bool` — Set this field to blacklist the contact for emails (emailBlacklisted = true)

**$extId:** `?string` — Pass your own Id to create a contact.

**$listIds:** `?array` — Ids of the lists to add the contact to

**$smsBlacklisted:** `?bool` — Set this field to blacklist the contact for SMS (smsBlacklisted = true)

**$smtpBlacklistSender:** `?array` — transactional email forbidden sender for contact. Use only for email Contact ( only available if updateEnabled = true )

**$updateEnabled:** `?bool` — Facilitate to update the existing contact in the same request (updateEnabled = true)

$client->contacts->getAttributes() -> GetAttributesResponse

#### 🔌 Usage

```php $client->contacts->getAttributes(); ```

$client->contacts->createAttribute($attributeCategory, $attributeName, $request)

#### 🔌 Usage

```php $client->contacts->createAttribute( CreateAttributeRequestAttributeCategory::Normal->value, 'attributeName', new CreateAttributeRequest([]), ); ```

#### ⚙️ Parameters

**$attributeCategory:** `string` — Category of the attribute

**$attributeName:** `string` — Name of the attribute

**$enumeration:** `?array` — List of values and labels that the attribute can take. **Use only if the attribute's category is "category"**. None of the category options can exceed max 200 characters. For example: **[{"value":1, "label":"male"}, {"value":2, "label":"female"}]**

**$isRecurring:** `?bool` — Type of the attribute. **Use only if the attribute's category is 'calculated' or 'global'**

**$multiCategoryOptions:** `?array` — List of options you want to add for multiple-choice attribute. **Use only if the attribute's category is "normal" and attribute's type is "multiple-choice". None of the multicategory options can exceed max 200 characters.** For example: **["USA","INDIA"]**

**$type:** `?string` — Type of the attribute. **Use only if the attribute's category is 'normal', 'category' or 'transactional'** Type **user and multiple-choice** is only available if the category is **normal** attribute Type **id** is only available if the category is **transactional** attribute Type **category** is only available if the category is **category** attribute

**$value:** `?string` — Value of the attribute. **Use only if the attribute's category is 'calculated' or 'global'**

$client->contacts->updateAttribute($attributeCategory, $attributeName, $request)

#### 🔌 Usage

```php $client->contacts->updateAttribute( UpdateAttributeRequestAttributeCategory::Category->value, 'attributeName', new UpdateAttributeRequest([]), ); ```

#### ⚙️ Parameters

**$attributeCategory:** `string` — Category of the attribute

**$attributeName:** `string` — Name of the existing attribute

**$enumeration:** `?array` — List of the values and labels that the attribute can take. **Use only if the attribute's category is "category"** None of the category options can exceed max 200 characters. For example, **[{"value":1, "label":"male"}, {"value":2, "label":"female"}]**

**$multiCategoryOptions:** `?array` — Use this option to add multiple-choice attributes options only if the attribute's category is "normal". **This option is specifically designed for updating multiple-choice attributes. None of the multicategory options can exceed max 200 characters.**. For example: **["USA","INDIA"]**

**$value:** `?string` — Value of the attribute to update. **Use only if the attribute's category is 'calculated' or 'global'**

$client->contacts->deleteAttribute($attributeCategory, $attributeName)

#### 🔌 Usage

```php $client->contacts->deleteAttribute( DeleteAttributeRequestAttributeCategory::Normal->value, 'attributeName', ); ```

#### ⚙️ Parameters

**$attributeCategory:** `string` — Category of the attribute

**$attributeName:** `string` — Name of the existing attribute

$client->contacts->deleteMultiAttributeOptions($attributeType, $multipleChoiceAttribute, $multipleChoiceAttributeOption)

#### 🔌 Usage

```php $client->contacts->deleteMultiAttributeOptions( 'multiple-choice', 'multipleChoiceAttribute', 'multipleChoiceAttributeOption', ); ```

#### ⚙️ Parameters

**$attributeType:** `string` — Type of the attribute

**$multipleChoiceAttribute:** `string` — Name of the existing multiple-choice attribute

**$multipleChoiceAttributeOption:** `string` — Name of the existing multiple-choice attribute option that you want to delete

$client->contacts->updateBatchContacts($request)

#### 🔌 Usage

```php $client->contacts->updateBatchContacts( new UpdateBatchContactsRequest([]), ); ```

#### ⚙️ Parameters

**$contacts:** `?array` — List of contacts to be updated

$client->contacts->createDoiContact($request)

#### 📝 Description

attributes param in this endpoint is an object containing key-value pairs where values can be either a string, integer, array, or boolean. You can create key-value pairs with these four datatypes. When a value is an array, it should be an array of strings.

#### 🔌 Usage

```php $client->contacts->createDoiContact( new CreateDoiContactRequest([ 'email' => 'elly@example.com', 'includeListIds' => [ 36, ], 'redirectionUrl' => 'http://requestb.in/173lyyx1', 'templateId' => 2, ]), ); ```

#### ⚙️ Parameters

**$attributes:** `?array` — Pass the set of attributes and their values. **These attributes must be present in your Brevo account**. For eg. **{'FNAME':'Elly', 'LNAME':'Roger', 'COUNTRIES': ['India','China']}**

**$email:** `string` — Email address where the confirmation email will be sent. This email address will be the identifier for all other contact attributes.

**$excludeListIds:** `?array` — Lists under user account where contact should not be added

**$includeListIds:** `array` — Lists under user account where contact should be added

**$redirectionUrl:** `string` — URL of the web page that user will be redirected to after clicking on the double opt in URL. When editing your DOI template you can reference this URL by using the tag **{{ params.DOIurl }}**.

**$templateId:** `int` — Id of the Double opt-in (DOI) template

$client->contacts->requestContactExport($request) -> RequestContactExportResponse

#### 📝 Description

It returns the background process ID which on completion calls the notify URL that you have set in the input. File will be available in csv.

#### 🔌 Usage

```php $client->contacts->requestContactExport( new RequestContactExportRequest([ 'customContactFilter' => new RequestContactExportRequestCustomContactFilter([]), ]), ); ```

#### ⚙️ Parameters

**$customContactFilter:** `RequestContactExportRequestCustomContactFilter` — Set the filter for the contacts to be exported.

**$disableNotification:** `?bool` — To avoid generating the email notification upon contact export, pass **true**

**$exportAttributes:** `?array` — List of all the attributes that you want to export. **These attributes must be present in your contact database. It is required if exportMandatoryAttributes is set false. ** For example: **['fname', 'lname', 'email']**

**$exportMandatoryAttributes:** `?bool` — To export mandatory attributes like EMAIL, ADDED_TIME, MODIFIED_TIME

**$exportMetadata:** `?array` — Export metadata of contacts such as _listIds, ADDED_TIME, MODIFIED_TIME.

**$exportDateInUtc:** `?bool` — Specifies whether the date fields createdAt, modifiedAt in the exported data should be returned in UTC format.

**$exportSubscriptionStatus:** `?array` — Export subscription status of contacts for email & sms marketting. Pass email_marketing to obtain the marketing email subscription status & sms_marketing to retrieve the marketing SMS status of the contact.

**$notifyUrl:** `?string` — Webhook that will be called once the export process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479

$client->contacts->getFolders($request) -> GetFoldersResponse

#### 📝 Description

Ongoing changes for this endpoint We're dropping support for the response attributes totalSubscribers and totalBlacklisted. These are non breaking changes. The default value for the attributes will be 0. The uniqueSubscribers field is deprecated

#### 🔌 Usage

```php $client->contacts->getFolders( new GetFoldersRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document of the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->contacts->createFolder($request) -> CreateFolderResponse

#### 🔌 Usage

```php $client->contacts->createFolder( new CreateUpdateFolder([]), ); ```

#### ⚙️ Parameters

**$request:** `CreateUpdateFolder`

$client->contacts->getFolder($folderId) -> GetFolder

#### 📝 Description

Ongoing changes for this endpoint. We're dropping support for the response attributes totalSubscribers and totalBlacklisted. These are non breaking changes. The default value for the attributes will be 0.

#### 🔌 Usage

```php $client->contacts->getFolder( 1000000, ); ```

#### ⚙️ Parameters

**$folderId:** `int` — id of the folder

$client->contacts->updateFolder($folderId, $request)

#### 🔌 Usage

```php $client->contacts->updateFolder( 1000000, new UpdateFolderRequest([ 'body' => new CreateUpdateFolder([]), ]), ); ```

#### ⚙️ Parameters

**$folderId:** `int` — Id of the folder

**$request:** `CreateUpdateFolder`

$client->contacts->deleteFolder($folderId)

#### 🔌 Usage

```php $client->contacts->deleteFolder( 1000000, ); ```

#### ⚙️ Parameters

**$folderId:** `int` — Id of the folder

$client->contacts->getFolderLists($folderId, $request) -> GetFolderListsResponse

#### 📝 Description

#### 🔌 Usage

```php $client->contacts->getFolderLists( 1000000, new GetFolderListsRequest([]), ); ```

#### ⚙️ Parameters

**$folderId:** `int` — Id of the folder

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document of the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->contacts->importContacts($request) -> ImportContactsResponse

#### 📝 Description

It returns the background process ID which on completion calls the notify URL that you have set in the input. **Note**: - Any contact attribute that doesn't exist in your account will be ignored at import end.

#### 🔌 Usage

```php $client->contacts->importContacts( new ImportContactsRequest([]), ); ```

#### ⚙️ Parameters

**$disableNotification:** `?bool` — To disable email notification

**$emailBlacklist:** `?bool` — To blacklist all the contacts for email

**$emptyContactsAttributes:** `?bool` — To facilitate the choice to erase any attribute of the existing contacts with empty value. emptyContactsAttributes = true means the empty fields in your import will erase any attribute that currently contain data in Brevo, & emptyContactsAttributes = false means the empty fields will not affect your existing data ( **only available if `updateExistingContacts` set to true **)

**$fileBody:** `?string` — **Mandatory if fileUrl and jsonBody is not defined.** CSV content to be imported. Use semicolon to separate multiple attributes. **Maximum allowed file body size is 10MB** . However we recommend a safe limit of around 8 MB to avoid the issues caused due to increase of file body size while parsing. Please use fileUrl instead to import bigger files.

**$fileUrl:** `?string` — **Mandatory if fileBody and jsonBody is not defined.** URL of the file to be imported (**no local file**). Possible file formats: #### .txt, .csv, .json

**$jsonBody:** `?array` — **Mandatory if fileUrl and fileBody is not defined.** JSON content to be imported. **Maximum allowed json body size is 10MB** . However we recommend a safe limit of around 8 MB to avoid the issues caused due to increase of json body size while parsing. Please use fileUrl instead to import bigger files.

**$listIds:** `?array` — **Mandatory if newList is not defined.** Ids of the lists in which the contacts shall be imported. For example, **[2, 4, 7]**.

**$newList:** `?ImportContactsRequestNewList` — To create a new list and import the contacts into it, pass the listName and an optional folderId.

**$notifyUrl:** `?string` — URL that will be called once the import process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479

**$smsBlacklist:** `?bool` — To blacklist all the contacts for sms

**$updateExistingContacts:** `?bool` — To facilitate the choice to update the existing contacts

$client->contacts->getLists($request) -> GetListsResponse

#### 📝 Description

#### 🔌 Usage

```php $client->contacts->getLists( new GetListsRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document of the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->contacts->createList($request) -> CreateListResponse

#### 🔌 Usage

```php $client->contacts->createList( new CreateListRequest([ 'folderId' => 2, 'name' => 'Magento Customer - ES', ]), ); ```

#### ⚙️ Parameters

**$folderId:** `int` — Id of the parent folder in which this list is to be created

**$name:** `string` — Name of the list

$client->contacts->getList($listId, $request) -> GetListResponse

#### 🔌 Usage

```php $client->contacts->getList( 1000000, new GetListRequest([]), ); ```

#### ⚙️ Parameters

**$listId:** `int` — Id of the list

**$startDate:** `?string` — **Mandatory if endDate is used**. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id. **Prefer to pass your timezone in date-time format for accurate result**

**$endDate:** `?string` — **Mandatory if startDate is used**. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id. **Prefer to pass your timezone in date-time format for accurate result**

$client->contacts->updateList($listId, $request)

#### 🔌 Usage

```php $client->contacts->updateList( 1000000, new UpdateListRequest([]), ); ```

#### ⚙️ Parameters

**$listId:** `int` — Id of the list

**$folderId:** `?int` — Id of the folder in which the list is to be moved. Either of the two parameters (name, folderId) can be updated at a time.

**$name:** `?string` — Name of the list. Either of the two parameters (name, folderId) can be updated at a time.

$client->contacts->deleteList($listId)

#### 🔌 Usage

```php $client->contacts->deleteList( 1000000, ); ```

#### ⚙️ Parameters

**$listId:** `int` — Id of the list

$client->contacts->getContactsFromList($listId, $request) -> GetContacts

#### 🔌 Usage

```php $client->contacts->getContactsFromList( 1000000, new GetContactsFromListRequest([]), ); ```

#### ⚙️ Parameters

**$listId:** `int` — Id of the list

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document of the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->contacts->addContactToList($listId, $request) -> PostContactInfo

#### 🔌 Usage

```php $client->contacts->addContactToList( 1000000, new AddContactToListRequest([ 'body' => new AddContactToListRequestBodyEmails([ 'emails' => [ 'jeff32@example.com', 'jim56@example.com', ], ]), ]), ); ```

#### ⚙️ Parameters

**$listId:** `int` — Id of the list

**$request:** `AddContactToListRequestBodyEmails|AddContactToListRequestBodyIds|AddContactToListRequestBodyExtIds`

$client->contacts->removeContactFromList($listId, $request) -> PostContactInfo

#### 🔌 Usage

```php $client->contacts->removeContactFromList( 1000000, new RemoveContactFromListRequest([ 'body' => new RemoveContactFromListRequestBodyEmails([]), ]), ); ```

#### ⚙️ Parameters

**$listId:** `int` — Id of the list

**$request:** `RemoveContactFromListRequestBodyEmails|RemoveContactFromListRequestBodyIds|RemoveContactFromListRequestBodyAll|RemoveContactFromListRequestBodyExtIds`

$client->contacts->getSegments($request) -> GetSegmentsResponse

#### 🔌 Usage

```php $client->contacts->getSegments( new GetSegmentsRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document of the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->contacts->getContactInfo($identifier, $request) -> GetContactInfoResponse

#### 📝 Description

Follow this format when passing a "SMS" phone number as an attribute. Accepted Number Formats 91xxxxxxxxxx +91xxxxxxxxxx 0091xxxxxxxxxx There are 2 ways to get a contact

Option 1- https://api.brevo.com/v3/contacts/{identifier}

Option 2- https://api.brevo.com/v3/contacts/{identifier}?identifierType={}

Option 1 only works if identifierType is email_id (for EMAIL), phone_id (for SMS) or contact_id (for ID of the contact),where you can directly pass the value of EMAIL, SMS and ID of the contact.

Option 2 works for all identifierType, use email_id for EMAIL attribute, phone_id for SMS attribute, contact_id for ID of the contact, ext_id for EXT_ID attribute, whatsapp_id for WHATSAPP attribute, landline_number_id for LANDLINE_NUMBER attribute

Along with the contact details, this endpoint will show the statistics of contact for the recent 90 days by default. To fetch the earlier statistics, please use Get contact campaign stats ``https://developers.brevo.com/reference/contacts-7#getcontactstats`` endpoint with the appropriate date ranges.

#### 🔌 Usage

```php $client->contacts->getContactInfo( 'identifier', new GetContactInfoRequest([]), ); ```

#### ⚙️ Parameters

**$identifier:** `string|int` — Email (urlencoded) OR ID of the contact OR its SMS attribute value OR EXT_ID attribute (urlencoded)

**$identifierType:** `?string` — email_id for Email, phone_id for SMS attribute, contact_id for ID of the contact, ext_id for EXT_ID attribute, whatsapp_id for WHATSAPP attribute, landline_number_id for LANDLINE_NUMBER attribute

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) of the statistic events specific to campaigns. Must be lower than equal to endDate

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) of the statistic events specific to campaigns. Must be greater than equal to startDate.

$client->contacts->updateContact($identifier, $request)

#### 📝 Description

Follow this format when passing a "SMS" phone number as an attribute. Accepted Number Formats 91xxxxxxxxxx +91xxxxxxxxxx 0091xxxxxxxxxx There are 2 ways to update a contact

Option 1- https://api.brevo.com/v3/contacts/{identifier}

Option 2- https://api.brevo.com/v3/contacts/{identifier}?identifierType={}

Option 1 only works if identifierType is email_id (for EMAIL) or contact_id (for ID of the contact),where you can directly pass the value of EMAIL and ID of the contact.

Option 2 works for all identifierType, use email_id for EMAIL attribute, contact_id for ID of the contact, ext_id for EXT_ID attribute, phone_id for SMS attribute, whatsapp_id for WHATSAPP attribute, landline_number_id for LANDLINE attribute

#### 🔌 Usage

```php $client->contacts->updateContact( 'identifier', new UpdateContactRequest([]), ); ```

#### ⚙️ Parameters

**$identifier:** `string|int` — Email (urlencoded) OR ID of the contact OR EXT_ID attribute (urlencoded) OR its SMS attribute value OR its WHATSAPP attribute value OR its LANDLINE attribute value

**$identifierType:** `?string` — email_id for Email, contact_id for ID of the contact, ext_id for EXT_ID attribute, phone_id for SMS attribute, whatsapp_id for WHATSAPP attribute, landline_number_id for LANDLINE attribute

**$attributes:** `?array` — Pass the set of attributes to be updated. **These attributes must be present in your account**. To update existing email address of a contact with the new one please pass EMAIL in attributes. For example, **{ "EMAIL":"newemail@domain.com", "FNAME":"Ellie", "LNAME":"Roger", "COUNTRIES":["India","China"]}**. The attribute's parameter should be passed in capital letter while updating a contact. Values that don't match the attribute type (e.g. text or string in a date attribute) will be ignored .Keep in mind transactional attributes can be updated the same way as normal attributes. Mobile Number in **SMS** field should be passed with proper country code. For example: **{"SMS":"+91xxxxxxxxxx"} or {"SMS":"0091xxxxxxxxxx"}**

**$emailBlacklisted:** `?bool` — Set/unset this field to blacklist/allow the contact for emails (emailBlacklisted = true)

**$extId:** `?string` — Pass your own Id to update ext_id of a contact.

**$listIds:** `?array` — Ids of the lists to add the contact to

**$smsBlacklisted:** `?bool` — Set/unset this field to blacklist/allow the contact for SMS (smsBlacklisted = true)

**$smtpBlacklistSender:** `?array` — transactional email forbidden sender for contact. Use only for email Contact

**$unlinkListIds:** `?array` — Ids of the lists to remove the contact from

$client->contacts->deleteContact($identifier, $request)

#### 📝 Description

There are 2 ways to delete a contact

Option 1- https://api.brevo.com/v3/contacts/{identifier}

Option 2- https://api.brevo.com/v3/contacts/{identifier}?identifierType={}

Option 1 only works if identifierType is email_id (for EMAIL) or contact_id (for ID of the contact),where you can directly pass the value of EMAIL and ID of the contact.

Option 2 works for all identifierType, use email_id for EMAIL attribute, contact_id for ID of the contact, ext_id for EXT_ID attribute, phone_id for SMS attribute, whatsapp_id for WHATSAPP attribute, landline_number_id for LANDLINE_NUMBER attribute.

#### 🔌 Usage

```php $client->contacts->deleteContact( 'identifier', new DeleteContactRequest([]), ); ```

#### ⚙️ Parameters

**$identifier:** `string|int` — Email (urlencoded) OR ID of the contact OR EXT_ID attribute (urlencoded)

$client->contacts->getContactStats($identifier, $request) -> GetContactStatsResponse

#### 🔌 Usage

```php $client->contacts->getContactStats( 'identifier', new GetContactStatsRequest([]), ); ```

#### ⚙️ Parameters

**$identifier:** `string|int` — Email (urlencoded) OR ID of the contact

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) of the statistic events specific to campaigns. Must be lower than equal to endDate

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) of the statistic events specific to campaigns. Must be greater than equal to startDate. Maximum difference between startDate and endDate should not be greater than 90 days

## Conversations

$client->conversations->setsAgentsStatusToOnlineFor23Minutes($request)

#### 📝 Description

We recommend pinging this endpoint every minute for as long as the agent has to be considered online.

#### 🔌 Usage

```php $client->conversations->setsAgentsStatusToOnlineFor23Minutes( new PostConversationsAgentOnlinePingRequest([ 'agentId' => "d9nKoegKSjmCtyK78", ]), ); ```

#### ⚙️ Parameters

**$agentEmail:** `mixed` — agent email. When sending online pings from a standalone system, it’s hard to maintain a 1-to-1 relationship between the users of both systems. In this case, an agent can be specified by their email address. If there’s no agent with the specified email address in your Brevo organization, a dummy agent will be created automatically.

**$agentId:** `mixed` — agent ID. It can be found on agent’s page or received from a webhook. Alternatively, you can use `agentEmail` + `agentName` + `receivedFrom` instead (all 3 fields required).

**$agentName:** `mixed` — agent name

**$receivedFrom:** `mixed` — mark your messages to distinguish messages created by you from the others.

$client->conversations->sendAMessageAsAnAgent($request) -> ConversationsMessage

#### 🔌 Usage

```php $client->conversations->sendAMessageAsAnAgent( new PostConversationsMessagesRequest([ 'agentId' => "d9nKoegKSjmCtyK78", 'text' => "Hello! How can I help you?", 'visitorId' => "kZMvWhf8npAu3H6qd57w2Hv6nh6rnxvg", ]), ); ```

#### ⚙️ Parameters

**$agentEmail:** `mixed` — agent email. When sending messages from a standalone system, it’s hard to maintain a 1-to-1 relationship between the users of both systems. In this case, an agent can be specified by their email address.

**$agentName:** `mixed` — agent name

**$receivedFrom:** `mixed` — mark your messages to distinguish messages created by you from the others.

**$text:** `mixed`

**$visitorId:** `mixed`

$client->conversations->getAMessage($id) -> ConversationsMessage

#### 🔌 Usage

```php $client->conversations->getAMessage( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — ID of the message

$client->conversations->updateAMessageSentByAnAgent($id, $request) -> ConversationsMessage

#### 📝 Description

Only agents’ messages can be edited.

#### 🔌 Usage

```php $client->conversations->updateAMessageSentByAnAgent( 'id', new PutConversationsMessagesIdRequest([ 'text' => 'Good morning! How can I help you?', ]), ); ```

#### ⚙️ Parameters

**$id:** `string` — ID of the message

**$text:** `string` — edited message text

$client->conversations->deleteAMessageSentByAnAgent($id)

#### 📝 Description

Only agents’ messages can be deleted.

#### 🔌 Usage

```php $client->conversations->deleteAMessageSentByAnAgent( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — ID of the message

$client->conversations->sendAnAutomatedMessageToAVisitor($request) -> ConversationsMessage

#### 📝 Description

Example of automated messages: order status, announce new features in your web app, etc.

#### 🔌 Usage

```php $client->conversations->sendAnAutomatedMessageToAVisitor( new PostConversationsPushedMessagesRequest([ 'groupId' => "PjRBMhWGen6aRHjif", 'text' => "Your order has shipped! Here’s your tracking number: 9114 5847 3325 9667 4328 88", 'visitorId' => "kZMvWhf8npAu3H6qd57w2Hv6nh6rnxvg", ]), ); ```

#### ⚙️ Parameters

**$agentId:** `mixed` — agent ID. It can be found on agent’s page or received from a webhook.

**$groupId:** `mixed` — group ID. It can be found on group’s page.

**$text:** `mixed`

**$visitorId:** `mixed`

$client->conversations->getAnAutomatedMessage($id) -> ConversationsMessage

#### 🔌 Usage

```php $client->conversations->getAnAutomatedMessage( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — ID of the message sent previously

$client->conversations->updateAnAutomatedMessage($id, $request) -> ConversationsMessage

#### 🔌 Usage

```php $client->conversations->updateAnAutomatedMessage( 'id', new PutConversationsPushedMessagesIdRequest([ 'text' => 'Your order has shipped! Here’s your tracking number: 9114 5847 4668 7775 9233 54', ]), ); ```

#### ⚙️ Parameters

**$id:** `string` — ID of the message

**$text:** `string` — edited message text

$client->conversations->deleteAnAutomatedMessage($id)

#### 🔌 Usage

```php $client->conversations->deleteAnAutomatedMessage( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — ID of the message

$client->conversations->setVisitorGroupAssignment($request) -> PutConversationsVisitorGroupResponse

#### 📝 Description

Assigns a visitor to a specific agent group or removes them from their current group.

#### 🔌 Usage

```php $client->conversations->setVisitorGroupAssignment( new PutConversationsVisitorGroupRequest([ 'groupId' => "PjRBMhWGen6aRHjif", ]), ); ```

#### ⚙️ Parameters

**$groupId:** `mixed`

## Ecommerce

$client->ecommerce->getCategories($request) -> GetCategoriesResponse

#### 🔌 Usage

```php $client->ecommerce->getCategories( new GetCategoriesRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

**$ids:** `?string` — Filter by category ids

**$name:** `?string` — Filter by category name

**$modifiedSince:** `?string` — Filter (urlencoded) the categories modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

**$createdSince:** `?string` — Filter (urlencoded) the categories created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

**$isDeleted:** `?string` — Filter categories by their deletion status. If `false` is passed, only categories that are not deleted will be returned.

$client->ecommerce->createUpdateCategory($request) -> CreateUpdateCategoryResponse

#### 🔌 Usage

```php $client->ecommerce->createUpdateCategory( new CreateUpdateCategoryRequest([ 'id' => 'CAT123', ]), ); ```

#### ⚙️ Parameters

**$deletedAt:** `?string` — UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) of the category deleted from the shop's database

**$id:** `string` — Unique Category ID as saved in the shop

**$isDeleted:** `?bool` — category deleted from the shop's database

**$name:** `?string` — **Mandatory in case of creation**. Name of the Category, as displayed in the shop

**$updateEnabled:** `?bool` — Facilitate to update the existing category in the same request (updateEnabled = true)

**$url:** `?string` — URL to the category

$client->ecommerce->createUpdateBatchCategory($request) -> CreateUpdateBatchCategoryResponse

#### 🔌 Usage

```php $client->ecommerce->createUpdateBatchCategory( new CreateUpdateBatchCategoryRequest([ 'categories' => [ new CreateUpdateBatchCategoryRequestCategoriesItem([ 'id' => 'CAT123', ]), ], ]), ); ```

#### ⚙️ Parameters

**$categories:** `array` — array of categories objects

**$updateEnabled:** `?bool` — Facilitate to update the existing categories in the same request (updateEnabled = true)

$client->ecommerce->getCategoryInfo($id) -> GetCategoryDetails

#### 🔌 Usage

```php $client->ecommerce->getCategoryInfo( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Category ID

$client->ecommerce->activateTheECommerceApp()

#### 📝 Description

Getting access to Brevo eCommerce.

#### 🔌 Usage

```php $client->ecommerce->activateTheECommerceApp(); ```

$client->ecommerce->getAttributionMetricsForOneOrMoreBrevoCampaignsOrWorkflows($request) -> GetEcommerceAttributionMetricsResponse

#### 🔌 Usage

```php $client->ecommerce->getAttributionMetricsForOneOrMoreBrevoCampaignsOrWorkflows( new GetEcommerceAttributionMetricsRequest([ 'periodFrom' => new DateTime('2022-01-02T00:00:00Z'), 'periodTo' => new DateTime('2022-01-03T00:00:00Z'), ]), ); ```

#### ⚙️ Parameters

**$periodFrom:** `?DateTime` — When getting metrics for a specific period, define the starting datetime in RFC3339 format

**$periodTo:** `?DateTime` — When getting metrics for a specific period, define the end datetime in RFC3339 format

**$emailCampaignIdArray:** `?string` — The email campaign ID(s) to get metrics for

**$smsCampaignIdArray:** `?string` — The SMS campaign ID(s) to get metrics for

**$automationWorkflowEmailIdArray:** `?string` — The automation workflow ID(s) to get email attribution metrics for

**$automationWorkflowSmsIdArray:** `?string` — The automation workflow ID(s) to get SMS attribution metrics for

$client->ecommerce->getDetailedAttributionMetricsForASingleBrevoCampaignOrWorkflow($conversionSource, $conversionSourceId) -> GetEcommerceAttributionMetricsConversionSourceConversionSourceIdResponse

#### 🔌 Usage

```php $client->ecommerce->getDetailedAttributionMetricsForASingleBrevoCampaignOrWorkflow( GetEcommerceAttributionMetricsConversionSourceConversionSourceIdRequestConversionSource::EmailCampaign->value, 'sale', ); ```

#### ⚙️ Parameters

**$conversionSource:** `string` — The Brevo campaign type or workflow type for which data will be retrieved

**$conversionSourceId:** `string` — The Brevo campaign or automation workflow id for which data will be retrieved

$client->ecommerce->getAttributedProductSalesForASingleBrevoCampaignOrWorkflow($conversionSource, $conversionSourceId) -> GetEcommerceAttributionProductsConversionSourceConversionSourceIdResponse

#### 🔌 Usage

```php $client->ecommerce->getAttributedProductSalesForASingleBrevoCampaignOrWorkflow( GetEcommerceAttributionProductsConversionSourceConversionSourceIdRequestConversionSource::EmailCampaign->value, 'sale', ); ```

#### ⚙️ Parameters

**$conversionSource:** `string` — The Brevo campaign or automation workflow type for which data will be retrieved

**$conversionSourceId:** `string` — The Brevo campaign or automation workflow id for which data will be retrieved

$client->ecommerce->getTheIso4217CompliantDisplayCurrencyCodeForYourBrevoAccount() -> GetEcommerceConfigDisplayCurrencyResponse

#### 🔌 Usage

```php $client->ecommerce->getTheIso4217CompliantDisplayCurrencyCodeForYourBrevoAccount(); ```

$client->ecommerce->setConfigDisplayCurrency($request) -> SetConfigDisplayCurrencyResponse

#### 🔌 Usage

```php $client->ecommerce->setConfigDisplayCurrency( new SetConfigDisplayCurrencyRequest([ 'code' => 'EUR', ]), ); ```

#### ⚙️ Parameters

**$code:** `string` — ISO 4217 compliant display currency code

$client->ecommerce->getOrders($request) -> mixed

#### 📝 Description

Get all the orders

#### 🔌 Usage

```php $client->ecommerce->getOrders( new GetOrdersRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

**$modifiedSince:** `?string` — Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

**$createdSince:** `?string` — Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

$client->ecommerce->createOrder($request)

#### 📝 Description

Manages the transactional status of the order

#### 🔌 Usage

```php $client->ecommerce->createOrder( new Order([ 'amount' => 308.42, 'createdAt' => '2021-07-29T20:59:23.383Z', 'id' => '14', 'products' => [ new OrderProductsItemQuantity([ 'quantity' => 10, ]), ], 'status' => 'completed', 'updatedAt' => '2021-07-30T10:59:23.383Z', ]), ); ```

#### ⚙️ Parameters

**$request:** `Order`

$client->ecommerce->createBatchOrder($request) -> CreateBatchOrderResponse

#### 📝 Description

Create multiple orders at one time instead of one order at a time

#### 🔌 Usage

```php $client->ecommerce->createBatchOrder( new CreateBatchOrderRequest([ 'orders' => [ new Order([ 'amount' => 308.42, 'createdAt' => '2021-07-29T20:59:23.383Z', 'id' => '14', 'products' => [ new OrderProductsItemQuantity([ 'quantity' => 10, ]), ], 'status' => 'completed', 'updatedAt' => '2021-07-30T10:59:23.383Z', ]), ], ]), ); ```

#### ⚙️ Parameters

**$historical:** `?bool` — Defines wether you want your orders to be considered as live data or as historical data (import of past data, synchronising data). True: orders will not trigger any automation workflows. False: orders will trigger workflows as usual.

**$notifyUrl:** `?string` — Notify Url provided by client_dev to get the status of batch request

**$orders:** `array` — array of order objects

$client->ecommerce->getProducts($request) -> GetProductsResponse

#### 🔌 Usage

```php $client->ecommerce->getProducts( new GetProductsRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

**$ids:** `?string` — Filter by product ids

**$name:** `?string` — Filter by product name, minimum 3 characters should be present for search.

**$priceLte:** `?float` — Price filter for products less than and equals to particular amount

**$priceGte:** `?float` — Price filter for products greater than and equals to particular amount

**$priceLt:** `?float` — Price filter for products less than particular amount

**$priceGt:** `?float` — Price filter for products greater than particular amount

**$priceEq:** `?float` — Price filter for products equals to particular amount

**$priceNe:** `?float` — Price filter for products not equals to particular amount

**$categories:** `?string` — Filter by categories ids

**$isDeleted:** `?string` — Filter products by their deletion status. If `false` is passed, only products that are not deleted will be returned.

$client->ecommerce->createUpdateProduct($request) -> CreateUpdateProductResponse

#### 🔌 Usage

```php $client->ecommerce->createUpdateProduct( new CreateUpdateProductRequest([ 'id' => 'P11', 'name' => 'Iphone 11', ]), ); ```

#### ⚙️ Parameters

**$categories:** `?array` — Category ID-s of the product

**$deletedAt:** `?string` — UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) of the product deleted from the shop's database

**$id:** `string` — Product ID for which you requested the details

**$imageUrl:** `?string` — Absolute URL to the cover image of the product

**$isDeleted:** `?bool` — product deleted from the shop's database

**$metaInfo:** `?array` — Meta data of product such as description, vendor, producer, stock level. The size of cumulative metaInfo shall not exceed **1000 KB**. Maximum length of metaInfo object can be 20.

**$name:** `string` — Mandatory in case of creation**. Name of the product for which you requested the details

**$parentId:** `?string` — Parent product id of the product

**$price:** `?float` — Price of the product

**$sku:** `?string` — Product identifier from the shop

**$stock:** `?float` — Current stock value of the product from the shop's database

**$updateEnabled:** `?bool` — Facilitate to update the existing category in the same request (updateEnabled = true)

**$url:** `?string` — URL to the product

$client->ecommerce->createUpdateBatchProducts($request) -> CreateUpdateBatchProductsResponse

#### 🔌 Usage

```php $client->ecommerce->createUpdateBatchProducts( new CreateUpdateBatchProductsRequest([ 'products' => [ new CreateUpdateBatchProductsRequestProductsItem([ 'id' => 'P11', 'name' => 'Iphone 11', ]), ], ]), ); ```

#### ⚙️ Parameters

**$products:** `array` — array of products objects

**$updateEnabled:** `?bool` — Facilitate to update the existing categories in the same request (updateEnabled = true)

$client->ecommerce->getProductInfo($id) -> GetProductDetails

#### 🔌 Usage

```php $client->ecommerce->getProductInfo( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Product ID

$client->ecommerce->createProductAlert($id, $type, $request)

#### 🔌 Usage

```php $client->ecommerce->createProductAlert( 'id', 'back_in_stock', new CreateProductAlertRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string` — Product ID

**$type:** `string` — Alert type

**$contactIdentifiers:** `?CreateProductAlertRequestContactIdentifiers`

## Coupons

$client->coupons->getCouponCollections($request) -> GetCouponCollection

#### 🔌 Usage

```php $client->coupons->getCouponCollections( new GetCouponCollectionsRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents returned per page

**$offset:** `?int` — Index of the first document on the page

**$sort:** `?string` — Sort the results by creation time in ascending/descending order

**$sortBy:** `?string` — The field used to sort coupon collections

$client->coupons->createCouponCollection($request) -> CreateCouponCollectionResponse

#### 🔌 Usage

```php $client->coupons->createCouponCollection( new CreateCouponCollectionRequest([ 'defaultCoupon' => 'Winter', 'name' => '10%OFF', ]), ); ```

#### ⚙️ Parameters

**$defaultCoupon:** `string` — Default coupons collection name

**$expirationDate:** `?DateTime` — Specify an expiration date for the coupon collection in RFC3339 format. Use null to remove the expiration date.

**$name:** `string` — Name of the coupons collection

**$remainingCouponsAlert:** `?int` — Send a notification alert (email) when the remaining coupons count is equal or fall bellow this number. Use null to disable alerts.

**$remainingDaysAlert:** `?int` — Send a notification alert (email) when the remaining days until the expiration date are equal or fall bellow this number. Use null to disable alerts.

$client->coupons->getCouponCollection($id) -> GetCouponCollection

#### 🔌 Usage

```php $client->coupons->getCouponCollection( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Id of the collection to return

$client->coupons->updateCouponCollection($id, $request) -> UpdateCouponCollectionResponse

#### 🔌 Usage

```php $client->coupons->updateCouponCollection( 'id', new UpdateCouponCollectionRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string` — Id of the collection to update

**$defaultCoupon:** `?string` — A default coupon to be used in case there are no coupons left

**$expirationDate:** `?DateTime` — Specify an expiration date for the coupon collection in RFC3339 format. Use null to remove the expiration date.

**$remainingCouponsAlert:** `?int` — Send a notification alert (email) when the remaining coupons count is equal or fall bellow this number. Use null to disable alerts.

**$remainingDaysAlert:** `?int` — Send a notification alert (email) when the remaining days until the expiration date are equal or fall bellow this number. Use null to disable alerts.

$client->coupons->createCoupons($request)

#### 🔌 Usage

```php $client->coupons->createCoupons( new CreateCouponsRequest([ 'collectionId' => '23befbae-1505-47a8-bd27-e30ef739f32c', 'coupons' => [ 'Uf12AF', ], ]), ); ```

#### ⚙️ Parameters

**$collectionId:** `string` — The id of the coupon collection for which the coupons will be created

**$coupons:** `array`

## Payments

$client->payments->createPaymentRequest($request) -> CreatePaymentRequestResponse

#### 🔌 Usage

```php $client->payments->createPaymentRequest( new CreatePaymentRequestRequest([ 'cart' => new Cart([ 'currency' => 'EUR', 'specificAmount' => 1200, ]), 'contactId' => 43, 'reference' => 'Invoice #INV0001', ]), ); ```

#### ⚙️ Parameters

**$cart:** `Cart`

**$configuration:** `?Configuration`

**$contactId:** `int` — Brevo ID of the contact requested to pay.

**$description:** `?string` — Description of payment request.

**$notification:** `?Notification`

**$reference:** `string` — Reference of the payment request, it will appear on the payment page.

$client->payments->getPaymentRequest($id) -> GetPaymentRequestResponse

#### 🔌 Usage

```php $client->payments->getPaymentRequest( '050db7b0-9bb7-4c1e-9c68-5a8dace8c1dc', ); ```

#### ⚙️ Parameters

**$id:** `string` — Id of the payment Request

$client->payments->deletePaymentRequest($id)

#### 🔌 Usage

```php $client->payments->deletePaymentRequest( '9ae7d68a-565c-4695-9381-d8fb3e3a14cc', ); ```

#### ⚙️ Parameters

**$id:** `string` — ID of the payment request.

## Event

$client->event->createEvent($request)

#### 📝 Description

Create an event to track a contact's interaction.

#### 🔌 Usage

```php $client->event->createEvent( new CreateEventRequest([ 'eventName' => 'video_played', 'identifiers' => new CreateEventRequestIdentifiers([]), ]), ); ```

#### ⚙️ Parameters

**$contactProperties:** `?array` — Properties defining the state of the contact associated to this event. Useful to update contact attributes defined in your contacts database while passing the event. For example: **"FIRSTNAME": "Jane" , "AGE": 37**

**$eventDate:** `?string` — Timestamp of when the event occurred (e.g. "2024-01-24T17:39:57+01:00"). If no value is passed, the timestamp of the event creation is used.

**$eventName:** `string` — The name of the event that occurred. This is how you will find your event in Brevo. Limited to 255 characters, alphanumerical characters and - _ only.

**$eventProperties:** `?array` — Properties of the event. Top level properties and nested properties can be used to better segment contacts and personalise workflow conditions. The following field type are supported: string, number, boolean (true/false), date (Timestamp e.g. "2024-01-24T17:39:57+01:00"). Keys are limited to 255 characters, alphanumerical characters and - _ only. Size is limited to 50Kb.

**$identifiers:** `CreateEventRequestIdentifiers` — Identifies the contact associated with the event. At least one identifier is required.

**$object:** `?CreateEventRequestObject` — Identifiers of the object record associated with this event. Ignored if the object type or identifier for this record does not exist on the account.

## InboundParsing

$client->inboundParsing->getInboundEmailEvents($request) -> GetInboundEmailEventsResponse

#### 📝 Description

This endpoint will show the list of all the events for the received emails.

#### 🔌 Usage

```php $client->inboundParsing->getInboundEmailEvents( new GetInboundEmailEventsRequest([]), ); ```

#### ⚙️ Parameters

**$sender:** `?string` — Email address of the sender.

**$startDate:** `?string` — Mandatory if endDate is used. Starting date (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSSZ) from which you want to fetch the list. Maximum time period that can be selected is one month.

**$endDate:** `?string` — Mandatory if startDate is used. Ending date (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSSZ) till which you want to fetch the list. Maximum time period that can be selected is one month.

**$limit:** `?int` — Number of documents returned per page

**$offset:** `?int` — Index of the first document on the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation

$client->inboundParsing->getInboundEmailEventsByUuid($uuid) -> GetInboundEmailEventsByUuidResponse

#### 📝 Description

This endpoint will show the list of all events history for one particular received email.

#### 🔌 Usage

```php $client->inboundParsing->getInboundEmailEventsByUuid( 'uuid', ); ```

#### ⚙️ Parameters

**$uuid:** `string` — UUID to fetch events specific to received email

$client->inboundParsing->getInboundEmailAttachment($downloadToken) -> string

#### 📝 Description

This endpoint will retrieve inbound attachment with download token.

#### 🔌 Usage

```php $client->inboundParsing->getInboundEmailAttachment( 'downloadToken', ); ```

#### ⚙️ Parameters

**$downloadToken:** `string` — Token to fetch a particular attachment

## Balance

$client->balance->getActiveBalancesApi($pid, $request) -> BalanceLimit

#### 📝 Description

Returns Active Balances

#### 🔌 Usage

```php $client->balance->getActiveBalancesApi( 'pid', new GetLoyaltyBalanceProgramsPidActiveBalanceRequest([ 'contactId' => 1, 'balanceDefinitionId' => 'balance_definition_id', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$limit:** `?int` — Limit

**$offset:** `?int` — Offset

**$sortField:** `?string` — Sort Field

**$sort:** `?string` — Sort Order

**$contactId:** `int` — Contact ID

**$balanceDefinitionId:** `string` — Balance Definition ID

$client->balance->getBalanceDefinitionList($pid, $request) -> GetBalanceDefinitionListResponse

#### 📝 Description

Returns balance definition page

#### 🔌 Usage

```php $client->balance->getBalanceDefinitionList( 'pid', new GetBalanceDefinitionListRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$limit:** `?int` — Limit the number of records returned

**$offset:** `?int` — Offset to paginate records

**$sortField:** `?string` — Field to sort by

**$sort:** `?string` — Sort direction

**$version:** `?string` — Version

$client->balance->createBalanceDefinition($pid, $request) -> BalanceDefinition

#### 📝 Description

Creates balance definition and returns information

#### 🔌 Usage

```php $client->balance->createBalanceDefinition( 'pid', new PostLoyaltyBalanceProgramsPidBalanceDefinitionsRequest([ 'name' => 'name', 'unit' => PostLoyaltyBalanceProgramsPidBalanceDefinitionsRequestUnit::Points->value, ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$balanceAvailabilityDurationModifier:** `?string` — Defines when the balance expires within the selected duration.

**$balanceAvailabilityDurationUnit:** `?string` — Unit of time for balance validity.

**$balanceAvailabilityDurationValue:** `?int` — Number of time units before the balance expires.

**$balanceExpirationDate:** `?DateTime` — Fixed expiration date (`dd/mm` format) as an alternative to duration-based expiry.

**$balanceOptionAmountOvertakingStrategy:** `?string` — Defines whether partial credit is allowed when reaching max balance.

**$balanceOptionCreditRounding:** `?string` — Defines rounding strategy for credit transactions.

**$balanceOptionDebitRounding:** `?string` — Defines rounding strategy for debit transactions.

**$description:** `?string` — Short description of the balance definition.

**$imageRef:** `?string` — URL of an optional image reference.

**$maxAmount:** `?float` — Maximum allowable balance amount.

**$maxCreditAmountLimit:** `?float` — Maximum credit allowed per operation.

**$maxDebitAmountLimit:** `?float` — Maximum debit allowed per operation.

**$meta:** `?array` — Additional metadata for the balance definition.

**$minAmount:** `?float` — Minimum allowable balance amount.

**$name:** `string` — Name of the balance definition.

**$unit:** `string` — Unit of balance measurement.

$client->balance->getBalanceDefinition($pid, $bdid, $request) -> BalanceDefinition

#### 📝 Description

Returns balance definition

#### 🔌 Usage

```php $client->balance->getBalanceDefinition( 'pid', 'bdid', new GetBalanceDefinitionRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$bdid:** `string` — Balance Definition Id

**$version:** `?string` — Version

$client->balance->updateBalanceDefinition($pid, $bdid, $request) -> BalanceDefinition

#### 📝 Description

Updates Balance definition

#### 🔌 Usage

```php $client->balance->updateBalanceDefinition( 'pid', 'bdid', new UpdateBalanceDefinitionRequest([ 'name' => 'name', 'unit' => UpdateBalanceDefinitionRequestUnit::Points->value, ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$bdid:** `string` — Balance Definition Id

**$balanceAvailabilityDurationModifier:** `?string` — Defines when the balance expires within the selected duration.

**$balanceAvailabilityDurationUnit:** `?string` — Unit of time for balance validity.

**$balanceAvailabilityDurationValue:** `?int` — Number of time units before the balance expires.

**$balanceExpirationDate:** `?string` — Expiration date (`dd/mm` format) or empty if not applicable.

**$balanceOptionAmountOvertakingStrategy:** `?string` — Defines whether partial credit is allowed when reaching max balance.

**$balanceOptionCreditRounding:** `?string` — Rounding strategy for credit transactions.

**$balanceOptionDebitRounding:** `?string` — Rounding strategy for debit transactions.

**$description:** `?string` — Short description of the balance definition.

**$imageRef:** `?string` — URL of an optional image reference.

**$maxAmount:** `?float` — Maximum allowable balance amount.

**$maxCreditAmountLimit:** `?float` — Maximum credit allowed per operation.

**$maxDebitAmountLimit:** `?float` — Maximum debit allowed per operation.

**$meta:** `?array` — Optional metadata for the balance definition.

**$minAmount:** `?float` — Minimum allowable balance amount.

**$name:** `string` — Name of the balance definition.

**$unit:** `string` — Unit of balance measurement.

$client->balance->deleteBalanceDefinition($pid, $bdid)

#### 📝 Description

Delete Balance definition

#### 🔌 Usage

```php $client->balance->deleteBalanceDefinition( 'pid', 'bdid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$bdid:** `string` — Balance Definition Id

$client->balance->createBalanceLimit($pid, $bdid, $request) -> BalanceLimit

#### 📝 Description

Creates balance limit and sends the created UUID along with the data

#### 🔌 Usage

```php $client->balance->createBalanceLimit( 'pid', 'bdid', new CreateBalanceLimitRequest([ 'constraintType' => CreateBalanceLimitRequestConstraintType::Transaction->value, 'durationUnit' => CreateBalanceLimitRequestDurationUnit::Day->value, 'durationValue' => 1, 'transactionType' => CreateBalanceLimitRequestTransactionType::Credit->value, 'value' => 1, ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$bdid:** `string` — Balance Definition Id

**$constraintType:** `string` — Defines whether the limit applies to transaction count or amount.

**$durationUnit:** `string` — Unit of time for which the limit is applicable.

**$durationValue:** `int` — Number of time units for the balance limit.

**$slidingSchedule:** `?bool` — Determines if the limit resets on a rolling schedule.

**$transactionType:** `string` — Specifies whether the limit applies to credit or debit transactions.

**$value:** `int` — Maximum allowed value for the specified constraint type.

$client->balance->getBalanceLimit($pid, $bdid, $blid, $request) -> BalanceLimit

#### 📝 Description

Fetches balance limits and send the created UUID along with the data

#### 🔌 Usage

```php $client->balance->getBalanceLimit( 'pid', 'bdid', 'blid', new GetBalanceLimitRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$bdid:** `string` — Balance Definition Id

**$blid:** `string` — Balance Limit Id

**$version:** `?string` — Version

$client->balance->updateBalanceLimit($pid, $bdid, $blid, $request) -> BalanceLimit

#### 📝 Description

Updates balance limit

#### 🔌 Usage

```php $client->balance->updateBalanceLimit( 'pid', 'bdid', 'blid', new UpdateBalanceLimitRequest([ 'constraintType' => UpdateBalanceLimitRequestConstraintType::Transaction->value, 'durationUnit' => UpdateBalanceLimitRequestDurationUnit::Day->value, 'durationValue' => 1, 'transactionType' => UpdateBalanceLimitRequestTransactionType::Credit->value, 'value' => 1, ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$bdid:** `string` — Balance Definition Id

**$blid:** `string` — Balance Limit Id

**$constraintType:** `string` — Defines whether the limit applies to transaction count or amount.

**$durationUnit:** `string` — Unit of time for which the limit is applicable.

**$durationValue:** `int` — Number of time units for the balance limit.

**$slidingSchedule:** `?bool` — Determines if the limit resets on a rolling schedule.

**$transactionType:** `string` — Specifies whether the limit applies to credit or debit transactions.

**$value:** `int` — Maximum allowed value for the specified constraint type.

$client->balance->deleteBalanceLimit($pid, $bdid, $blid)

#### 📝 Description

Delete balance limit

#### 🔌 Usage

```php $client->balance->deleteBalanceLimit( 'pid', 'bdid', 'blid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$bdid:** `string` — Balance Definition Id

**$blid:** `string` — Balance Limit Id

$client->balance->getContactBalances($pid) -> GetContactBalancesResponse

#### 📝 Description

Returns balance list

#### 🔌 Usage

```php $client->balance->getContactBalances( 'pid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

$client->balance->createBalanceOrder($pid, $request) -> CreateBalanceOrderResponse

#### 📝 Description

Returns created order

#### 🔌 Usage

```php $client->balance->createBalanceOrder( 'pid', new CreateBalanceOrderRequest([ 'amount' => 1.1, 'balanceDefinitionId' => 'balanceDefinitionId', 'contactId' => 1, 'dueAt' => 'dueAt', 'source' => 'source', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$amount:** `float` — Order amount (must be non-zero).

**$balanceDefinitionId:** `string` — Unique identifier (UUID) of the associated balance definition.

**$contactId:** `int` — Unique identifier of the contact placing the order (must be ≥ 1).

**$dueAt:** `string` — RFC3339 timestamp specifying when the order is due.

**$expiresAt:** `?string` — Optional RFC3339 timestamp defining order expiration.

**$meta:** `?array` — Optional metadata associated with the order.

**$source:** `string` — Specifies the origin of the order (`engine` or `user`).

$client->balance->getSubscriptionBalances($pid, $cid) -> GetSubscriptionBalancesResponse

#### 📝 Description

Returns subscription balances

#### 🔌 Usage

```php $client->balance->getSubscriptionBalances( 'pid', 'cid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$cid:** `string` — Contact Id

$client->balance->createSubscriptionBalances($pid, $cid, $request) -> PostLoyaltyBalanceProgramsPidSubscriptionsCidBalancesResponse

#### 📝 Description

Creates a balance for a contact

#### 🔌 Usage

```php $client->balance->createSubscriptionBalances( 'pid', 'cid', new PostLoyaltyBalanceProgramsPidSubscriptionsCidBalancesRequest([ 'balanceDefinitionId' => 'balanceDefinitionId', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$cid:** `string` — Contact Id

**$balanceDefinitionId:** `string` — Unique identifier (UUID) of the balance definition associated with the new balance.

$client->balance->getTransactionHistoryApi($pid, $request) -> GetLoyaltyBalanceProgramsPidTransactionHistoryResponse

#### 📝 Description

Returns transaction history

#### 🔌 Usage

```php $client->balance->getTransactionHistoryApi( 'pid', new GetLoyaltyBalanceProgramsPidTransactionHistoryRequest([ 'contactId' => 1, 'balanceDefinitionId' => 'balanceDefinitionId', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$limit:** `?int` — Limit the number of records returned

**$offset:** `?int` — Skip a number of records

**$sortField:** `?string` — Field to sort by

**$sort:** `?string` — Sort order, either asc or desc

**$contactId:** `int` — Contact ID

**$balanceDefinitionId:** `string` — Balance Definition ID

**$filters:** `?string` — Filters to apply

$client->balance->beginTransaction($pid, $request) -> Transaction

#### 📝 Description

Creates new transaction and returns information

#### 🔌 Usage

```php $client->balance->beginTransaction( 'pid', new BeginTransactionRequest([ 'amount' => 1.1, 'balanceDefinitionId' => 'balanceDefinitionId', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$loyaltySubscriptionId:** `?string` — Unique identifier for the loyalty subscription (required unless `contactId` is provided).

**$amount:** `float` — Transaction amount (must be provided).

**$autoComplete:** `?bool` — Whether the transaction should be automatically completed.

**$balanceDefinitionId:** `string` — Unique identifier (UUID) of the associated balance definition.

**$balanceExpiryInMinutes:** `?int` — Optional expiry time for the balance in minutes (must be greater than 0 if provided).

**$contactId:** `?int` — Unique identifier of the contact involved in the transaction (required unless `LoyaltySubscriptionId` is provided).

**$eventTime:** `?string` — Optional timestamp specifying when the transaction occurred.

**$meta:** `?array` — Optional metadata associated with the transaction.

**$ttl:** `?int` — Optional time-to-live for the transaction (must be greater than 0 if provided).

$client->balance->cancelTransaction($pid, $tid) -> Transaction

#### 📝 Description

Cancels transaction

#### 🔌 Usage

```php $client->balance->cancelTransaction( 'pid', 'tid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$tid:** `string` — Transaction Id

$client->balance->completeTransaction($pid, $tid) -> Transaction

#### 📝 Description

Completes transaction

#### 🔌 Usage

```php $client->balance->completeTransaction( 'pid', 'tid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program Id

**$tid:** `string` — Transaction Id

## Program

$client->program->getLpList($request) -> GetLpListResponse

#### 📝 Description

Returns list of loyalty programs

#### 🔌 Usage

```php $client->program->getLpList( new GetLpListRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page

**$sortField:** `?string` — Sort documents by field

**$sort:** `?string` — Sort documents by field

$client->program->createNewLp($request) -> LoyaltyProgram

#### 📝 Description

Creates loyalty program

#### 🔌 Usage

```php $client->program->createNewLp( new CreateNewLpRequest([ 'name' => 'name', ]), ); ```

#### ⚙️ Parameters

**$description:** `?string` — Optional description of the loyalty program (max 256 chars).

**$documentId:** `?string` — Optional unique document ID.

**$meta:** `?array` — Optional metadata related to the loyalty program.

**$name:** `string` — Required name of the loyalty program (max 128 chars).

$client->program->getLoyaltyProgramInfo($pid) -> LoyaltyProgram

#### 📝 Description

Returns loyalty program

#### 🔌 Usage

```php $client->program->getLoyaltyProgramInfo( 'pid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

$client->program->updateLoyaltyProgram($pid, $request) -> LoyaltyProgram

#### 📝 Description

Updates loyalty program

#### 🔌 Usage

```php $client->program->updateLoyaltyProgram( 'pid', new UpdateLoyaltyProgramRequest([ 'name' => 'name', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

**$description:** `?string` — Loyalty Program description

**$meta:** `?array` — Loyalty Program meta data

**$name:** `string` — Loyalty Program name

$client->program->deleteLoyaltyProgram($pid)

#### 📝 Description

Deletes Loyalty Program

#### 🔌 Usage

```php $client->program->deleteLoyaltyProgram( 'pid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

$client->program->partiallyUpdateLoyaltyProgram($pid, $request) -> LoyaltyProgram

#### 📝 Description

Partially updates loyalty program

#### 🔌 Usage

```php $client->program->partiallyUpdateLoyaltyProgram( 'pid', new PartiallyUpdateLoyaltyProgramRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

**$description:** `?string` — Loyalty Program description

**$meta:** `?array` — Loyalty Program meta data

**$name:** `?string` — Loyalty Program name

$client->program->getParameterSubscriptionInfo($pid, $request) -> GetParameterSubscriptionInfoResponse

#### 📝 Description

Get Information of balances, tiers, rewards and subscription members for a subscription

#### 🔌 Usage

```php $client->program->getParameterSubscriptionInfo( 'pid', new GetParameterSubscriptionInfoRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

**$contactId:** `?string` — The contact ID to filter by.

**$params:** `?string` — A list of filter parameters for querying the subscription info.

**$loyaltySubscriptionId:** `?string` — The loyalty subscription ID to filter by.

$client->program->deleteContactSubscription($pid, $cid)

#### 📝 Description

Delete subscription for a contact

#### 🔌 Usage

```php $client->program->deleteContactSubscription( 'pid', 1, ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

**$cid:** `int` — Contact ID.

$client->program->publishLoyaltyProgram($pid)

#### 📝 Description

Publishes loyalty program

#### 🔌 Usage

```php $client->program->publishLoyaltyProgram( 'pid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

$client->program->subscribeMemberToASubscription($pid, $request) -> SubscribeMemberToASubscriptionResponse

#### 📝 Description

Add member to a subscription

#### 🔌 Usage

```php $client->program->subscribeMemberToASubscription( 'pid', new SubscribeMemberToASubscriptionRequest([ 'memberContactIds' => [ 1, ], ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

**$contactId:** `?int` — Required if LoyaltySubscriptionId is not provided, must be greater than 0

**$loyaltySubscriptionId:** `?string` — Required if ContactId is not provided, max length 64

**$memberContactIds:** `array` — Required, each item must be greater than or equal to 1

$client->program->deleteContactMembers($pid, $request)

#### 📝 Description

Deletes member from a subscription

#### 🔌 Usage

```php $client->program->deleteContactMembers( 'pid', new DeleteContactMembersRequest([ 'memberContactIds' => 'memberContactIds', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

**$memberContactIds:** `string` — Comma-separated list of member contact IDs to delete from the subscription.

$client->program->subscribeToLoyaltyProgram($pid, $request) -> SubscribeToLoyaltyProgramResponse

#### 📝 Description

Subscribes to a loyalty program

#### 🔌 Usage

```php $client->program->subscribeToLoyaltyProgram( 'pid', new SubscribeToLoyaltyProgramRequest([ 'contactId' => 1, ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID. A unique identifier for the loyalty program.

**$contactId:** `int` — Required contact ID; must be greater than 0.

**$creationDate:** `?string` — Optional custom date-time format.

**$loyaltySubscriptionId:** `?string` — Optional subscription ID (max length 64).

## Reward

$client->reward->getCodeCount($pid, $cpid) -> GetCodeCountResponse

#### 📝 Description

Get code count

#### 🔌 Usage

```php $client->reward->getCodeCount( 'pid', 'cpid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$cpid:** `string` — Code Pool ID

$client->reward->getRewardPageApi($pid, $request) -> GetLoyaltyOfferProgramsPidOffersResponse

#### 📝 Description

Returns a reward page

#### 🔌 Usage

```php $client->reward->getRewardPageApi( 'pid', new GetLoyaltyOfferProgramsPidOffersRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$limit:** `?int` — Page size

**$offset:** `?int` — Pagination offset

**$state:** `?string` — State of the reward

**$version:** `?string` — Version

$client->reward->createReward($pid, $request) -> CreateRewardResponse

#### 📝 Description

Creates a new reward in the loyalty program.

#### 🔌 Usage

```php $client->reward->createReward( 'pid', new CreateRewardRequest([ 'name' => 'name', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$name:** `string` — Internal name of the reward

**$publicDescription:** `?string` — Public facing description of the reward

**$publicImage:** `?string` — URL of the public image for the reward

**$publicName:** `?string` — Public facing name of the reward

$client->reward->createVoucher($pid, $request) -> CreateVoucherResponse

#### 📝 Description

Create a voucher and attribute it to a specific membership.

#### 🔌 Usage

```php $client->reward->createVoucher( 'pid', new CreateVoucherRequest([ 'rewardId' => 'rewardId', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$code:** `?string` — Code generated to attribute reward to a contact

**$contactId:** `?int` — Contact to attribute the reward

**$expirationDate:** `?string` — Reward expiration date

**$loyaltySubscriptionId:** `?string` — One of contactId or loyaltySubscriptionId is required

**$meta:** `?array` — Offer meta information (key/value object)

**$rewardId:** `string` — Reward id

**$value:** `?float` — Value of the selected reward config

$client->reward->redeemVoucher($pid, $request) -> Redeem

#### 📝 Description

Creates a request to redeem a voucher.

#### 🔌 Usage

```php $client->reward->redeemVoucher( 'pid', new RedeemVoucherRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$attributedRewardId:** `?string` — Unique identifier for the attributed reward

**$code:** `?string` — Redemption code for the reward

**$contactId:** `?int` — Unique identifier for the contact

**$loyaltySubscriptionId:** `?string` — Identifier for the loyalty subscription

**$meta:** `?array` — Additional metadata associated with the redeem request

**$order:** `?RedeemVoucherRequestOrder` — Order details for the redemption

**$rewardId:** `?string` — Unique identifier for the reward

**$ttl:** `?int` — Time to live in seconds for the redemption request

$client->reward->completeRedeemTransaction($pid, $tid) -> Redeem

#### 📝 Description

Completes voucher redeem request.

#### 🔌 Usage

```php $client->reward->completeRedeemTransaction( 'pid', 'tid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$tid:** `string` — Redeem transaction ID

$client->reward->revokeVouchers($pid, $request)

#### 📝 Description

Revoke attributed vouchers.

#### 🔌 Usage

```php $client->reward->revokeVouchers( 'pid', new RevokeVouchersRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$attributedRewardIds:** `?string` — Reward Attribution IDs (comma seperated)

$client->reward->validateReward($pid, $request) -> ValidateRewardResponse

#### 📝 Description

Validates a reward.

#### 🔌 Usage

```php $client->reward->validateReward( 'pid', new ValidateRewardRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$attributedRewardId:** `?string` — Unique identifier for the attributed reward

**$code:** `?string` — Validation code for the reward

**$contactId:** `?int` — Unique identifier for the contact

**$loyaltySubscriptionId:** `?string` — Identifier for the loyalty subscription

**$pointOfSellId:** `?string` — Identifier for the point of sale

**$rewardId:** `?string` — Unique identifier for the reward

$client->reward->getRewardInformation($pid, $rid, $request) -> GetLoyaltyOfferProgramsPidRewardsRidResponse

#### 📝 Description

Returns reward information.

#### 🔌 Usage

```php $client->reward->getRewardInformation( 'pid', 'rid', new GetLoyaltyOfferProgramsPidRewardsRidRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$rid:** `string` — Reward ID

**$version:** `?string` — Version

$client->reward->getVoucherForAContact($pid, $request) -> GetLoyaltyOfferProgramsPidVouchersResponse

#### 📝 Description

Get voucher for a contact

#### 🔌 Usage

```php $client->reward->getVoucherForAContact( 'pid', new GetLoyaltyOfferProgramsPidVouchersRequest([ 'contactId' => 1, ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$limit:** `?int` — Page size

**$offset:** `?int` — Pagination offset

**$sort:** `?string` — Sort order

**$sortField:** `?string` — Sort field

**$contactId:** `int` — Contact ID

**$metadataKeyValue:** `?string` — Metadata value for a Key filter

**$rewardId:** `?string` — Reward ID

## Tier

$client->tier->addSubscriptionToTier($pid, $cid, $tid) -> AddSubscriptionToTierResponse

#### 📝 Description

Manually assigns a tier to a specific membership.

#### 🔌 Usage

```php $client->tier->addSubscriptionToTier( 'pid', 'cid', 'tid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$cid:** `string` — Contact ID

**$tid:** `string` — Tier ID

$client->tier->getListOfTierGroups($pid, $request) -> GetListOfTierGroupsResponse

#### 📝 Description

Returns the list of tier groups defined within the loyalty program.

#### 🔌 Usage

```php $client->tier->getListOfTierGroups( 'pid', new GetListOfTierGroupsRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$version:** `?string` — Select 'active' to retrieve list of all tier groups which are live for clients. Select draft to retrieve list of all non deleted tier groups.

$client->tier->createTierGroup($pid, $request) -> TierGroup

#### 📝 Description

Creates a new tier group in a loyalty program. *(The changes will take effect with the next publication of the loyalty program)*

#### 🔌 Usage

```php $client->tier->createTierGroup( 'pid', new CreateTierGroupRequest([ 'name' => 'name', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$downgradeStrategy:** `?string` — Select real_time to downgrade tier on real time balance updates. Select membership_anniversary to downgrade tier on subscription anniversary. Select tier_anniversary to downgrade tier on tier anniversary.

**$name:** `string` — Name of the tier group

**$tierOrder:** `?array` — Order of the tiers in the group in ascending order

**$upgradeStrategy:** `?string` — Select real_time to upgrade tier on real time balance updates. Select membership_anniversary to upgrade tier on subscription anniversary. Select tier_anniversary to upgrade tier on tier anniversary.

$client->tier->getTierGroup($pid, $gid, $request) -> TierGroup

#### 📝 Description

Returns tier group information.

#### 🔌 Usage

```php $client->tier->getTierGroup( 'pid', 'gid', new GetTierGroupRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$gid:** `string` — Tier group ID

**$version:** `?string` — Select active to retrieve active version of tier group. Select draft to retrieve latest changes in tier group.

$client->tier->updateTierGroup($pid, $gid, $request) -> TierGroup

#### 📝 Description

Updates a tier group from a loyalty program. *(The changes will take effect with the next publication of the loyalty program)*

#### 🔌 Usage

```php $client->tier->updateTierGroup( 'pid', 'gid', new UpdateTierGroupRequest([ 'downgradeStrategy' => UpdateTierGroupRequestDowngradeStrategy::RealTime->value, 'name' => 'name', 'tierOrder' => [ 'tierOrder', ], 'upgradeStrategy' => UpdateTierGroupRequestUpgradeStrategy::RealTime->value, ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$gid:** `string` — Tier group ID

**$downgradeStrategy:** `string` — Select real_time to downgrade tier on real time balance updates. Select membership_anniversary to downgrade tier on subscription anniversary. Select tier_anniversary to downgrade tier on tier anniversary.

**$name:** `string` — Name of the tier group

**$tierOrder:** `array` — Order of the tiers in the group in ascending order

**$upgradeStrategy:** `string` — Select real_time to upgrade tier on real time balance updates. Select membership_anniversary to upgrade tier on subscription anniversary. Select tier_anniversary to upgrade tier on tier anniversary.

$client->tier->deleteTierGroup($pid, $gid)

#### 📝 Description

Deletes a tier group from a loyalty program. *(The changes will take effect with the next publication of the loyalty program)*

#### 🔌 Usage

```php $client->tier->deleteTierGroup( 'pid', 'gid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$gid:** `string` — Tier group ID

$client->tier->createTierForTierGroup($pid, $gid, $request) -> Tier

#### 📝 Description

Creates a new tier in a loyalty program tier group. *(The changes will take effect with the next publication of the loyalty program)*

#### 🔌 Usage

```php $client->tier->createTierForTierGroup( 'pid', 'gid', new CreateTierForTierGroupRequest([ 'accessConditions' => [ new CreateTierForTierGroupRequestAccessConditionsItem([]), ], 'name' => 'name', ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$gid:** `string` — Tier group ID

**$accessConditions:** `array`

**$imageRef:** `?string` — Image of the tier

**$name:** `string` — Name of the tier to be created

**$tierRewards:** `?array`

$client->tier->getLoyaltyProgramTier($pid, $request) -> GetLoyaltyProgramTierResponse

#### 📝 Description

Returns the list of tiers defined within the loyalty program.

#### 🔌 Usage

```php $client->tier->getLoyaltyProgramTier( 'pid', new GetLoyaltyProgramTierRequest([]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$version:** `?string` — Select 'active' to retrieve list of all tiers which are live for clients. Select draft to retrieve list of all non deleted tiers.

$client->tier->updateTier($pid, $tid, $request) -> Tier

#### 📝 Description

Modifies an existing tier for the specified tier group *(The changes will take effect with the next publication of the loyalty program)*

#### 🔌 Usage

```php $client->tier->updateTier( 'pid', 'tid', new UpdateTierRequest([ 'accessConditions' => [ new UpdateTierRequestAccessConditionsItem([]), ], 'name' => 'name', 'tierRewards' => [ new UpdateTierRequestTierRewardsItem([]), ], ]), ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$tid:** `string` — Tier ID

**$accessConditions:** `array`

**$imageRef:** `?string` — Image of the tier

**$name:** `string` — Name of the tier to be created

**$tierRewards:** `array`

$client->tier->deleteTier($pid, $tid)

#### 📝 Description

Deletes a tier from a loyalty program tier group. *(The changes will take effect with the next publication of the loyalty program)*

#### 🔌 Usage

```php $client->tier->deleteTier( 'pid', 'tid', ); ```

#### ⚙️ Parameters

**$pid:** `string` — Loyalty Program ID

**$tid:** `string` — Tier ID

## EmailCampaigns

$client->emailCampaigns->getEmailCampaigns($request) -> GetEmailCampaignsResponse

#### 📝 Description

The response payload for this endpoint has changed You now need to specify which type of statistics you would like to retrieve. For more information visit [this page](https://developers.brevo.com/changelog/get-all-marketing-campaigns).

#### 🔌 Usage

```php $client->emailCampaigns->getEmailCampaigns( new GetEmailCampaignsRequest([]), ); ```

#### ⚙️ Parameters

**$type:** `?string` — Filter on the type of the campaigns

**$status:** `?string` — Filter on the status of the campaign

**$statistics:** `?string` — Filter on type of the statistics required. Example **globalStats** value will only fetch globalStats info of the campaign in returned response.This option only returns data for events occurred in the last 6 months.For older campaigns, it’s advisable to use the **Get Campaign Report** endpoint.

**$startDate:** `?string` — **Mandatory if endDate is used**. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent email campaigns. **Prefer to pass your timezone in date-time format for accurate result** ( only available if either 'status' not passed and if passed is set to 'sent' )

**$endDate:** `?string` — **Mandatory if startDate is used**. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent email campaigns. **Prefer to pass your timezone in date-time format for accurate result** ( only available if either 'status' not passed and if passed is set to 'sent' )

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

**$excludeHtmlContent:** `?bool` — Use this flag to exclude htmlContent from the response body. If set to **true**, htmlContent field will be returned as empty string in the response body

$client->emailCampaigns->createEmailCampaign($request) -> CreateEmailCampaignResponse

#### 🔌 Usage

```php $client->emailCampaigns->createEmailCampaign( new CreateEmailCampaignRequest([ 'name' => 'Newsletter - May 2017', 'sender' => new CreateEmailCampaignRequestSender([]), ]), ); ```

#### ⚙️ Parameters

**$abTesting:** `?bool` — Status of A/B Test. abTesting = false means it is disabled & abTesting = true means it is enabled. **subjectA, subjectB, splitRule, winnerCriteria & winnerDelay** will be considered when abTesting is set to true. subjectA & subjectB are mandatory together & subject if passed is ignored. **Can be set to true only if sendAtBestTime is false**. You will be able to set up two subject lines for your campaign and send them to a random sample of your total recipients. Half of the test group will receive version A, and the other half will receive version B

**$attachmentUrl:** `?string` — Absolute url of the attachment (no local file). Extension allowed: #### xlsx, xls, ods, docx, docm, doc, csv, pdf, txt, gif, jpg, jpeg, png, tif, tiff, rtf, bmp, cgm, css, shtml, html, htm, zip, xml, ppt, pptx, tar, ez, ics, mobi, msg, pub and eps

**$emailExpirationDate:** `?CreateEmailCampaignRequestEmailExpirationDate` — To reduce your carbon footprint, set an expiration date for your email. If supported, it will be automatically deleted from the recipient’s inbox, saving storage space and energy. Learn more about setting an email expiration date. For reference , ``https://help.brevo.com/hc/en-us/articles/4413566705298-Create-an-email-campaign``

**$footer:** `?string` — Footer of the email campaign

**$header:** `?string` — Header of the email campaign

**$htmlContent:** `?string` — Mandatory if htmlUrl and templateId are empty. Body of the message (HTML).

**$htmlUrl:** `?string` — **Mandatory if htmlContent and templateId are empty**. Url to the message (HTML). For example: **https://html.domain.com**

**$increaseRate:** `?int` — **Mandatory if ipWarmupEnable is set to true**. Set a percentage increase rate for warming up your ip. We recommend you set the increase rate to 30% per day. If you want to send the same number of emails every day, set the daily increase value to 0%.

**$initialQuota:** `?int` — **Mandatory if ipWarmupEnable is set to true**. Set an initial quota greater than 1 for warming up your ip. We recommend you set a value of 3000.

**$inlineImageActivation:** `?bool` — Use true to embedded the images in your email. Final size of the email should be less than **4MB**. Campaigns with embedded images can _not be sent to more than 5000 contacts_

**$ipWarmupEnable:** `?bool` — **Available for dedicated ip clients**. Set this to true if you wish to warm up your ip.

**$mirrorActive:** `?bool` — Use true to enable the mirror link

**$name:** `string` — Name of the campaign

**$params:** `?array` — Pass the set of attributes to customize the type classic campaign. For example: **{"FNAME":"Joe", "LNAME":"Doe"}**. Only available if **type** is **classic**. It's considered only if campaign is in _New Template Language format_. The New Template Language is dependent on the values of **subject, htmlContent/htmlUrl, sender.name & toField**

**$previewText:** `?string` — Preview text or preheader of the email campaign

**$recipients:** `?CreateEmailCampaignRequestRecipients` — Segment ids and List ids to include/exclude from campaign

**$replyTo:** `?string` — Email on which the campaign recipients will be able to reply to

**$scheduledAt:** `?string` — Sending UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result**. If sendAtBestTime is set to true, your campaign will be sent according to the date passed (ignoring the time part). For example: **2017-06-01T12:30:00+02:00**

**$sendAtBestTime:** `?bool` — Set this to true if you want to send your campaign at best time.

**$sender:** `CreateEmailCampaignRequestSender` — Sender details including id or email and name (_optional_). Only one of either Sender's email or Sender's ID shall be passed in one request at a time. For example: **{"name":"xyz", "email":"example@abc.com"}** **{"name":"xyz", "id":123}**

**$splitRule:** `?int` — Add the size of your test groups. **Mandatory if abTesting = true & 'recipients' is passed**. We'll send version A and B to a random sample of recipients, and then the winning version to everyone else

**$subject:** `?string` — Subject of the campaign. **Mandatory if abTesting is false**. Ignored if abTesting is true.

**$subjectA:** `?string` — Subject A of the campaign. **Mandatory if abTesting = true**. subjectA & subjectB should have unique value

**$subjectB:** `?string` — Subject B of the campaign. **Mandatory if abTesting = true**. subjectA & subjectB should have unique value

**$tag:** `?string` — Tag of the campaign

**$templateId:** `?int` — **Mandatory if htmlContent and htmlUrl are empty**. Id of the transactional email template with status _active_. Used to copy only its content fetched from htmlContent/htmlUrl to an email campaign for RSS feature.

**$toField:** `?string` — To personalize the **To** Field. If you want to include the first name and last name of your recipient, add **{FNAME} {LNAME}**. These contact attributes must already exist in your Brevo account. If input parameter **params** used please use **{{contact.FNAME}} {{contact.LNAME}}** for personalization

**$unsubscriptionPageId:** `?string` — Enter an unsubscription page id. The page id is a 24 digit alphanumeric id that can be found in the URL when editing the page. If not entered, then the default unsubscription page will be used.

**$updateFormId:** `?string` — **Mandatory if templateId is used containing the {{ update_profile }} tag**. Enter an update profile form id. The form id is a 24 digit alphanumeric id that can be found in the URL when editing the form. If not entered, then the default update profile form will be used.

**$utmCampaign:** `?string` — Customize the utm_campaign value. If this field is empty, the campaign name will be used. Only alphanumeric characters and spaces are allowed

**$winnerCriteria:** `?string` — Choose the metrics that will determinate the winning version. **Mandatory if _splitRule_ >= 1 and < 50**. If splitRule = 50, `winnerCriteria` is ignored if passed

**$winnerDelay:** `?int` — Choose the duration of the test in hours. Maximum is 7 days, pass 24*7 = 168 hours. The winning version will be sent at the end of the test. **Mandatory if _splitRule_ >= 1 and < 50**. If splitRule = 50, `winnerDelay` is ignored if passed

$client->emailCampaigns->uploadImageToGallery($request) -> UploadImageToGalleryResponse

#### 🔌 Usage

```php $client->emailCampaigns->uploadImageToGallery( new UploadImageToGalleryRequest([ 'imageUrl' => 'https://somedomain.com/image1.jpg', ]), ); ```

#### ⚙️ Parameters

**$imageUrl:** `string` — The absolute url of the image (**no local file**). Maximum allowed size for image is **2MB**. Allowed extensions for images are: #### jpeg, jpg, png, bmp, gif.

**$name:** `?string` — Name of the image.

$client->emailCampaigns->getEmailCampaign($campaignId, $request) -> GetEmailCampaignResponse

#### 🔌 Usage

```php $client->emailCampaigns->getEmailCampaign( 1000000, new GetEmailCampaignRequest([]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

**$statistics:** `?string` — Filter on type of the statistics required. Example **globalStats** value will only fetch globalStats info of the campaign in returned response.

$client->emailCampaigns->updateEmailCampaign($campaignId, $request)

#### 🔌 Usage

```php $client->emailCampaigns->updateEmailCampaign( 1000000, new UpdateEmailCampaignRequest([]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

**$emailExpirationDate:** `?UpdateEmailCampaignRequestEmailExpirationDate` — To reduce your carbon footprint, set an expiration date for your email. If supported, it will be automatically deleted from the recipient’s inbox, saving storage space and energy.

**$footer:** `?string` — Footer of the email campaign

**$header:** `?string` — Header of the email campaign

**$htmlContent:** `?string` — Body of the message (HTML version). If the campaign is designed using Drag & Drop editor via HTML content, then the design page will not have Drag & Drop editor access for that campaign. **REQUIRED if htmlUrl is empty**

**$htmlUrl:** `?string` — Url which contents the body of the email message. **REQUIRED if htmlContent is empty**

**$increaseRate:** `?int` — Set a percentage increase rate for warming up your ip. We recommend you set the increase rate to 30% per day. If you want to send the same number of emails every day, set the daily increase value to 0%.

**$initialQuota:** `?int` — Set an initial quota greater than 1 for warming up your ip. We recommend you set a value of 3000.

**$inlineImageActivation:** `?bool` — Status of inline image. inlineImageActivation = false means image can’t be embedded, & inlineImageActivation = true means image can be embedded, in the email. You cannot send a campaign of more than **4MB** with images embedded in the email. Campaigns with the images embedded in the email _must be sent to less than 5000 contacts_.

**$ipWarmupEnable:** `?bool` — **Available for dedicated ip clients**. Set this to true if you wish to warm up your ip.

**$mirrorActive:** `?bool` — Status of mirror links in campaign. mirrorActive = false means mirror links are deactivated, & mirrorActive = true means mirror links are activated, in the campaign

**$name:** `?string` — Name of the campaign

**$previewText:** `?string` — Preview text or preheader of the email campaign

**$recipients:** `?UpdateEmailCampaignRequestRecipients` — Segment ids and List ids to include/exclude from campaign

**$recurring:** `?bool` — **FOR TRIGGER ONLY !** Type of trigger campaign.recurring = false means contact can receive the same Trigger campaign only once, & recurring = true means contact can receive the same Trigger campaign several times

**$replyTo:** `?string` — Email on which campaign recipients will be able to reply to

**$scheduledAt:** `?string` — UTC date-time on which the campaign has to run (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** If sendAtBestTime is set to true, your campaign will be sent according to the date passed (ignoring the time part).

**$sendAtBestTime:** `?bool` — Set this to true if you want to send your campaign at best time. Note:- **if true, warmup ip will be disabled.**

**$sender:** `?UpdateEmailCampaignRequestSender` — Sender details including id or email and name (optional). Only one of either Sender's email or Sender's ID shall be passed in one request at a time. For example: **{"name":"xyz", "email":"example@abc.com"}** **{"name":"xyz", "id":123}**

**$subject:** `?string` — Subject of the campaign

**$subjectA:** `?string` — Subject A of the campaign. **Mandatory if abTesting = true**. subjectA & subjectB should have unique value

**$subjectB:** `?string` — Subject B of the campaign. **Mandatory if abTesting = true**. subjectA & subjectB should have unique value

**$tag:** `?string` — Tag of the campaign

**$unsubscriptionPageId:** `?string` — Enter an unsubscription page id. The page id is a 24 digit alphanumeric id that can be found in the URL when editing the page.

**$utmCampaign:** `?string` — Customize the utm_campaign value. If this field is empty, the campaign name will be used. Only alphanumeric characters and spaces are allowed

**$winnerCriteria:** `?string` — Choose the metrics that will determinate the winning version. **Mandatory if _splitRule_ >= 1 and < 50**. If splitRule = 50, `winnerCriteria` is ignored if passed

$client->emailCampaigns->deleteEmailCampaign($campaignId)

#### 🔌 Usage

```php $client->emailCampaigns->deleteEmailCampaign( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the campaign

$client->emailCampaigns->getAbTestCampaignResult($campaignId) -> GetAbTestCampaignResultResponse

#### 📝 Description

Obtain winning version of an A/B test email campaign

#### 🔌 Usage

```php $client->emailCampaigns->getAbTestCampaignResult( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the A/B test campaign

$client->emailCampaigns->emailExportRecipients($campaignId, $request) -> EmailExportRecipientsResponse

#### 🔌 Usage

```php $client->emailCampaigns->emailExportRecipients( 1000000, new EmailExportRecipientsRequest([ 'recipientsType' => EmailExportRecipientsRequestRecipientsType::All->value, ]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

**$notifyUrl:** `?string` — Webhook called once the export process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479

**$recipientsType:** `string` — Type of recipients to export for a campaign

$client->emailCampaigns->sendEmailCampaignNow($campaignId)

#### 🔌 Usage

```php $client->emailCampaigns->sendEmailCampaignNow( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

$client->emailCampaigns->sendReport($campaignId, $request)

#### 📝 Description

A PDF will be sent to the specified email addresses

#### 🔌 Usage

```php $client->emailCampaigns->sendReport( 1000000, new SendReportRequest([ 'body' => new SendReport([ 'email' => new SendReportEmail([ 'body' => 'Please find attached the report of our last email campaign.', 'to' => [ 'jim.suehan@example.com', ], ]), ]), ]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

**$request:** `SendReport`

$client->emailCampaigns->sendTestEmail($campaignId, $request)

#### 🔌 Usage

```php $client->emailCampaigns->sendTestEmail( 1000000, new SendTestEmailRequest([ 'body' => new SendTestEmail([]), ]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

**$request:** `SendTestEmail`

$client->emailCampaigns->getSharedTemplateUrl($campaignId) -> GetSharedTemplateUrlResponse

#### 📝 Description

Get a unique URL to share & import an email template from one Brevo account to another.

#### 🔌 Usage

```php $client->emailCampaigns->getSharedTemplateUrl( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign or template

$client->emailCampaigns->updateCampaignStatus($campaignId, $request)

#### 🔌 Usage

```php $client->emailCampaigns->updateCampaignStatus( 1000000, new UpdateCampaignStatusRequest([ 'body' => new UpdateCampaignStatus([]), ]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

**$request:** `UpdateCampaignStatus`

## SmsCampaigns

$client->smsCampaigns->getSmsCampaigns($request) -> GetSmsCampaignsResponse

#### 🔌 Usage

```php $client->smsCampaigns->getSmsCampaigns( new GetSmsCampaignsRequest([]), ); ```

#### ⚙️ Parameters

**$status:** `?string` — Status of campaign.

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent sms campaigns. **Prefer to pass your timezone in date-time format for accurate result** ( only available if either 'status' not passed and if passed is set to 'sent' )

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent sms campaigns. **Prefer to pass your timezone in date-time format for accurate result** ( only available if either 'status' not passed and if passed is set to 'sent' )

**$limit:** `?int` — Number limitation for the result returned

**$offset:** `?int` — Beginning point in the list to retrieve from.

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->smsCampaigns->createSmsCampaign($request) -> CreateSmsCampaignResponse

#### 🔌 Usage

```php $client->smsCampaigns->createSmsCampaign( new CreateSmsCampaignRequest([ 'content' => 'Get a discount by visiting our NY store and saying : Happy Spring!', 'name' => 'Spring Promo Code', 'sender' => 'MyShop', ]), ); ```

#### ⚙️ Parameters

**$content:** `string` — Content of the message. The **maximum characters used per SMS is 160**, if used more than that, it will be counted as more than one SMS.

**$name:** `string` — Name of the campaign

**$organisationPrefix:** `?string` — A recognizable prefix will ensure your audience knows who you are. Recommended by U.S. carriers. This will be added as your Brand Name before the message content. **Prefer verifying maximum length of 160 characters including this prefix in message content to avoid multiple sending of same sms.**

**$recipients:** `?CreateSmsCampaignRequestRecipients`

**$scheduledAt:** `?string` — UTC date-time on which the campaign has to run (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

**$sender:** `string` — Name of the sender. **The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters**

**$unicodeEnabled:** `?bool` — Format of the message. It indicates whether the content should be treated as unicode or not.

**$unsubscribeInstruction:** `?string` — Instructions to unsubscribe from future communications. Recommended by U.S. carriers. Must include **STOP** keyword. This will be added as instructions after the end of message content. **Prefer verifying maximum length of 160 characters including this instructions in message content to avoid multiple sending of same sms.**

$client->smsCampaigns->getSmsCampaign($campaignId) -> GetSmsCampaignResponse

#### 🔌 Usage

```php $client->smsCampaigns->getSmsCampaign( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the SMS campaign

$client->smsCampaigns->updateSmsCampaign($campaignId, $request)

#### 🔌 Usage

```php $client->smsCampaigns->updateSmsCampaign( 1000000, new UpdateSmsCampaignRequest([]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the SMS campaign

**$content:** `?string` — Content of the message. The **maximum characters used per SMS is 160**, if used more than that, it will be counted as more than one SMS

**$name:** `?string` — Name of the campaign

**$recipients:** `?UpdateSmsCampaignRequestRecipients`

**$scheduledAt:** `?string` — UTC date-time on which the campaign has to run (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**

**$sender:** `?string` — Name of the sender. **The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters**

**$unicodeEnabled:** `?bool` — Format of the message. It indicates whether the content should be treated as unicode or not.

$client->smsCampaigns->deleteSmsCampaign($campaignId)

#### 🔌 Usage

```php $client->smsCampaigns->deleteSmsCampaign( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the SMS campaign

$client->smsCampaigns->requestSmsRecipientExport($campaignId, $request) -> RequestSmsRecipientExportResponse

#### 📝 Description

It returns the background process ID which on completion calls the notify URL that you have set in the input.

#### 🔌 Usage

```php $client->smsCampaigns->requestSmsRecipientExport( 1000000, new RequestSmsRecipientExportRequest([ 'recipientsType' => RequestSmsRecipientExportRequestRecipientsType::All->value, ]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the campaign

**$notifyUrl:** `?string` — URL that will be called once the export process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479

**$recipientsType:** `string` — Filter the recipients based on how they interacted with the campaign

$client->smsCampaigns->sendSmsCampaignNow($campaignId)

#### 🔌 Usage

```php $client->smsCampaigns->sendSmsCampaignNow( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the campaign

$client->smsCampaigns->sendSmsReport($campaignId, $request)

#### 📝 Description

Send report of Sent and Archived campaign, to the specified email addresses, with respective data and a pdf attachment in detail.

#### 🔌 Usage

```php $client->smsCampaigns->sendSmsReport( 1000000, new SendSmsReportRequest([ 'body' => new SendReport([ 'email' => new SendReportEmail([ 'body' => 'Please find attached the report of our last email campaign.', 'to' => [ 'jim.suehan@example.com', ], ]), ]), ]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the campaign

**$request:** `SendReport`

$client->smsCampaigns->sendTestSms($campaignId, $request)

#### 🔌 Usage

```php $client->smsCampaigns->sendTestSms( 1000000, new SendTestSmsRequest([]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the SMS campaign

**$phoneNumber:** `?string` — Mobile number of the recipient with the country code. This number **must belong to one of your contacts in Brevo account and must not be blacklisted**

$client->smsCampaigns->updateSmsCampaignStatus($campaignId, $request)

#### 🔌 Usage

```php $client->smsCampaigns->updateSmsCampaignStatus( 1000000, new UpdateSmsCampaignStatusRequest([ 'body' => new UpdateCampaignStatus([]), ]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the campaign

**$request:** `UpdateCampaignStatus`

## WhatsAppCampaigns

$client->whatsAppCampaigns->getWhatsAppCampaigns($request) -> GetWhatsAppCampaignsResponse

#### 🔌 Usage

```php $client->whatsAppCampaigns->getWhatsAppCampaigns( new GetWhatsAppCampaignsRequest([]), ); ```

#### ⚙️ Parameters

**$startDate:** `?string` — **Mandatory if endDate is used**. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the WhatsApp campaigns created. **Prefer to pass your timezone in date-time format for accurate result**

**$endDate:** `?string` — **Mandatory if startDate is used**. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the WhatsApp campaigns created. **Prefer to pass your timezone in date-time format for accurate result**

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record modification. Default order is **descending** if `sort` is not passed

$client->whatsAppCampaigns->createWhatsAppCampaign($request) -> CreateWhatsAppCampaignResponse

#### 📝 Description

You can use this API for WhatsApp only if you have setup your WhatsApp account on Brevo platform. To setup your WhatsApp account, follow the steps in the guide below. [Activating Whatsapp](https://developers.brevo.com/docs/whatsapp-campaigns-1) in your account This API requires the List and Segment ids as recipients in Body params.You can use the below Contact endpoints to get the required information. [Get all the Lists](https://developers.brevo.com/reference/getlists-1) [Get all the Segments](https://developers.brevo.com/reference/getsegments)

#### 🔌 Usage

```php $client->whatsAppCampaigns->createWhatsAppCampaign( new CreateWhatsAppCampaignRequest([ 'name' => 'Test Campaign', 'recipients' => new CreateWhatsAppCampaignRequestRecipients([]), 'scheduledAt' => '2017-06-01T12:30:00+02:00', 'templateId' => 19, ]), ); ```

#### ⚙️ Parameters

**$name:** `string` — Name of the WhatsApp campaign creation

**$recipients:** `CreateWhatsAppCampaignRequestRecipients` — Segment ids and List ids to include/exclude from campaign

**$scheduledAt:** `string` — Sending UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.For example: **2017-06-01T12:30:00+02:00**

**$templateId:** `int` — Id of the WhatsApp template in **approved** state

$client->whatsAppCampaigns->getWhatsAppConfig() -> GetWhatsAppConfigResponse

#### 📝 Description

#### 🔌 Usage

```php $client->whatsAppCampaigns->getWhatsAppConfig(); ```

$client->whatsAppCampaigns->createWhatsAppTemplate($request) -> CreateWhatsAppTemplateResponse

#### 📝 Description

#### 🔌 Usage

```php $client->whatsAppCampaigns->createWhatsAppTemplate( new CreateWhatsAppTemplateRequest([ 'bodyText' => 'making it look like readable English', 'category' => CreateWhatsAppTemplateRequestCategory::Marketing->value, 'language' => 'en', 'name' => 'Test template', ]), ); ```

#### ⚙️ Parameters

**$bodyText:** `string` — Body of the template. **Maximum allowed characters are 1024**

**$category:** `string` — Category of the template

**$headerText:** `?string` — Text content of the header in the template. **Maximum allowed characters are 45** **Use this field to add text content in template header and if mediaUrl is empty**

**$language:** `string` Language of the template. For Example : **en** for English

**$mediaUrl:** `?string` — Absolute url of the media file **(no local file)** for the header. **Use this field in you want to add media in Template header and headerText is empty** Allowed extensions for media files are: #### jpeg | png | mp4 | pdf

**$name:** `string` — Name of the template

**$source:** `?string` — source of the template

$client->whatsAppCampaigns->getWhatsAppTemplates($request) -> GetWhatsAppTemplatesResponse

#### 🔌 Usage

```php $client->whatsAppCampaigns->getWhatsAppTemplates( new GetWhatsAppTemplatesRequest([]), ); ```

#### ⚙️ Parameters

**$startDate:** `?string` — **Mandatory if endDate is used**. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the templates created. **Prefer to pass your timezone in date-time format for accurate result**

**$endDate:** `?string` — **Mandatory if startDate is used**. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the templates created. **Prefer to pass your timezone in date-time format for accurate result**

**$limit:** `?int` — Number of documents per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record modification. Default order is **descending** if `sort` is not passed

**$source:** `?string` — source of the template

$client->whatsAppCampaigns->sendWhatsAppTemplateApproval($templateId)

#### 📝 Description

#### 🔌 Usage

```php $client->whatsAppCampaigns->sendWhatsAppTemplateApproval( 1000000, ); ```

#### ⚙️ Parameters

**$templateId:** `int` — id of the template

$client->whatsAppCampaigns->getWhatsAppCampaign($campaignId) -> GetWhatsAppCampaignResponse

#### 📝 Description

#### 🔌 Usage

```php $client->whatsAppCampaigns->getWhatsAppCampaign( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — Id of the campaign

$client->whatsAppCampaigns->updateWhatsAppCampaign($campaignId, $request)

#### 📝 Description

#### 🔌 Usage

```php $client->whatsAppCampaigns->updateWhatsAppCampaign( 1000000, new UpdateWhatsAppCampaignRequest([]), ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the campaign

**$campaignName:** `?string` — Name of the campaign

**$campaignStatus:** `?string` — Status of the campaign

**$recipients:** `?UpdateWhatsAppCampaignRequestRecipients` — Segment ids and List ids to include/exclude from campaign

**$rescheduleFor:** `?string` — Reschedule the sending UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) of campaign. **Prefer to pass your timezone in date-time format for accurate result.For example: **2017-06-01T12:30:00+02:00** Use this field to update the scheduledAt of any existing draft or scheduled WhatsApp campaign.

$client->whatsAppCampaigns->deleteWhatsAppCampaign($campaignId)

#### 🔌 Usage

```php $client->whatsAppCampaigns->deleteWhatsAppCampaign( 1000000, ); ```

#### ⚙️ Parameters

**$campaignId:** `int` — id of the campaign

## Companies

$client->companies->getAllCompanies($request) -> GetCompaniesResponse

#### 🔌 Usage

```php $client->companies->getAllCompanies( new GetCompaniesRequest([]), ); ```

#### ⚙️ Parameters

**$filters:** `?string` — Filter by attrbutes. If you have filter for owner on your side please send it as {"attributes.owner":"6299dcf3874a14eacbc65c46"}

**$linkedContactsIds:** `?int` — Filter by linked contacts ids

**$linkedDealsIds:** `?string` — Filter by linked Deals ids

**$modifiedSince:** `?string` — Filter (urlencoded) the contacts modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.

**$createdSince:** `?string` — Filter (urlencoded) the contacts created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.

**$page:** `?int` — Index of the first document of the page

**$limit:** `?int` — Number of documents per page

**$sort:** `?string` — Sort the results in the ascending/descending order. Default order is **descending** by creation if `sort` is not passed

**$sortBy:** `?string` — The field used to sort field names.

$client->companies->createACompany($request) -> PostCompaniesResponse

#### 🔌 Usage

```php $client->companies->createACompany( new PostCompaniesRequest([ 'name' => 'company', ]), ); ```

#### ⚙️ Parameters

**$attributes:** `?array` — Attributes for company creation

**$countryCode:** `?int` — Country code if phone_number is passed in attributes.

**$linkedContactsIds:** `?array` — Contact ids to be linked with company

**$linkedDealsIds:** `?array` — Deal ids to be linked with company

**$name:** `string` — Name of company

$client->companies->importCompaniesCreationAndUpdation($request) -> PostCompaniesImportResponse

#### 📝 Description

Import companies from a CSV file with mapping options.

#### 🔌 Usage

```php $client->companies->importCompaniesCreationAndUpdation( new PostCompaniesImportRequest([ 'file' => File::createFromString("example_file", "example_file"), ]), ); ```

$client->companies->linkAndUnlinkCompanyWithContactAndDeal($id, $request)

#### 🔌 Usage

```php $client->companies->linkAndUnlinkCompanyWithContactAndDeal( 'id', new PatchCompaniesLinkUnlinkIdRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string`

**$linkContactIds:** `?array` — Contact ids for contacts to be linked with company

**$linkDealsIds:** `?array` — Deal ids for deals to be linked with company

**$unlinkContactIds:** `?array` — Contact ids for contacts to be unlinked from company

**$unlinkDealsIds:** `?array` — Deal ids for deals to be unlinked from company

$client->companies->getACompany($id) -> Company

#### 🔌 Usage

```php $client->companies->getACompany( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Get Company Details

$client->companies->deleteACompany($id)

#### 🔌 Usage

```php $client->companies->deleteACompany( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Company ID to delete

$client->companies->updateACompany($id, $request) -> Company

#### 🔌 Usage

```php $client->companies->updateACompany( 'id', new PatchCompaniesIdRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string`

**$attributes:** `?array` — Attributes for company update

**$countryCode:** `?int` — Country code if phone_number is passed in attributes.

**$linkedContactsIds:** `?array` — Warning - Using PATCH on linkedContactIds replaces the list of linked contacts. Omitted IDs will be removed.

**$linkedDealsIds:** `?array` — Warning - Using PATCH on linkedDealsIds replaces the list of linked contacts. Omitted IDs will be removed.

**$name:** `?string` — Name of company

$client->companies->createACompanyDealAttribute($request) -> PostCrmAttributesResponse

#### 🔌 Usage

```php $client->companies->createACompanyDealAttribute( new PostCrmAttributesRequest([ 'attributeType' => PostCrmAttributesRequestAttributeType::Text->value, 'label' => 'Attribute Label', 'objectType' => PostCrmAttributesRequestObjectType::Companies->value, ]), ); ```

#### ⚙️ Parameters

**$attributeType:** `string` — The type of attribute (must be one of the defined enums)

**$description:** `?string` — A description of the attribute

**$label:** `string` — The label for the attribute (max 50 characters, cannot be empty)

**$objectType:** `string` — The type of object the attribute belongs to (prefilled with `companies`, mandatory)

**$optionsLabels:** `?array` — Options for multi-choice or single-select attributes

$client->companies->deleteAnAttribute($id)

#### 🔌 Usage

```php $client->companies->deleteAnAttribute( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Attribute ID

$client->companies->updateAnAttribute($id, $request)

#### 🔌 Usage

```php $client->companies->updateAnAttribute( 'id', new PatchCrmAttributesIdRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string` — Attribute ID

**$label:** `?string` — Attribute display label

**$optionsLabels:** `?array` — Updated labels for selectable options

**$objectType:** `?string` — The type of object the attribute belongs to, it cannot be updated after creation

$client->companies->getCompanyAttributes() -> array

#### 🔌 Usage

```php $client->companies->getCompanyAttributes(); ```

## Deals

$client->deals->getDealAttributes() -> array

#### 🔌 Usage

```php $client->deals->getDealAttributes(); ```

$client->deals->getAllDeals($request) -> GetCrmDealsResponse

#### 🔌 Usage

```php $client->deals->getAllDeals( new GetCrmDealsRequest([]), ); ```

#### ⚙️ Parameters

**$filtersAttributesDealName:** `?string` — Filter by attributes. If you have a filter for the owner on your end, please send it as filters[attributes.deal_owner] and utilize the account email for the filtering.

**$filtersLinkedCompaniesIds:** `?string` — Filter by linked companies ids

**$filtersLinkedContactsIds:** `?string` — Filter by linked companies ids

**$createdSince:** `?string` — Filter (urlencoded) the contacts created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.

**$offset:** `?int` — Index of the first document of the page

**$limit:** `?int` — Number of documents per page

**$sort:** `?string` — Sort the results in the ascending/descending order. Default order is **descending** by creation if `sort` is not passed

$client->deals->createADeal($request) -> PostCrmDealsResponse

#### 🔌 Usage

```php $client->deals->createADeal( new PostCrmDealsRequest([ 'name' => 'Deal: Connect with company', ]), ); ```

#### ⚙️ Parameters

**$attributes:** `?array` — Attributes for deal creation To assign owner of a Deal you can send attributes.deal_owner and utilize the account email or ID. If you want to create a deal on a specific pipeline and stage you can use the following attributes `pipeline` and `deal_stage`. Pipeline and deal_stage are ids you can fetch using this endpoint `/crm/pipeline/details/{pipelineID}`

**$linkedCompaniesIds:** `?array` — Company ids to be linked with deal

**$linkedContactsIds:** `?array` — Contact ids to be linked with deal

**$name:** `string` — Name of deal

$client->deals->importDealsCreationAndUpdation($request) -> PostCrmDealsImportResponse

#### 📝 Description

Import deals from a CSV file with mapping options.

#### 🔌 Usage

```php $client->deals->importDealsCreationAndUpdation( new PostCrmDealsImportRequest([ 'file' => File::createFromString("example_file", "example_file"), ]), ); ```

$client->deals->linkAndUnlinkADealWithContactsAndCompanies($id, $request)

#### 🔌 Usage

```php $client->deals->linkAndUnlinkADealWithContactsAndCompanies( 'id', new PatchCrmDealsLinkUnlinkIdRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string`

**$linkCompanyIds:** `?array` — Company ids to be linked with deal

**$linkContactIds:** `?array` — Contact ids for contacts to be linked with deal

**$unlinkCompanyIds:** `?array` — Company ids to be unlinked from deal

**$unlinkContactIds:** `?array` — Contact ids for contacts to be unlinked from deal

$client->deals->getADeal($id) -> Deal

#### 🔌 Usage

```php $client->deals->getADeal( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string`

$client->deals->deleteADeal($id)

#### 🔌 Usage

```php $client->deals->deleteADeal( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string`

$client->deals->updateADeal($id, $request)

#### 🔌 Usage

```php $client->deals->updateADeal( 'id', new PatchCrmDealsIdRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string`

**$attributes:** `?array` — Attributes for deal update To assign owner of a Deal you can send attributes.deal_owner and utilize the account email or ID. If you wish to update the pipeline of a deal you need to provide the `pipeline` and the `deal_stage` Pipeline and deal_stage are ids you can fetch using this endpoint `/crm/pipeline/details/{pipelineID}`

**$linkedCompaniesIds:** `?array` — Warning - Using PATCH on linkedCompaniesIds replaces the list of linked contacts. Omitted IDs will be removed.

**$linkedContactsIds:** `?array` — Warning - Using PATCH on linkedContactIds replaces the list of linked contacts. Omitted IDs will be removed.

**$name:** `?string` — Name of deal

$client->deals->getPipelineStages() -> Pipeline

#### 📝 Description

This endpoint is deprecated. Prefer /crm/pipeline/details/{pipelineID} instead.

#### 🔌 Usage

```php $client->deals->getPipelineStages(); ```

$client->deals->getAllPipelines() -> array

#### 🔌 Usage

```php $client->deals->getAllPipelines(); ```

$client->deals->getAPipeline($pipelineId) -> array

#### 🔌 Usage

```php $client->deals->getAPipeline( 'pipelineID', ); ```

#### ⚙️ Parameters

**$pipelineId:** `string`

## Files

$client->files->getAllFiles($request) -> array

#### 🔌 Usage

```php $client->files->getAllFiles( new GetCrmFilesRequest([]), ); ```

#### ⚙️ Parameters

**$entity:** `?string` — Filter by file entity type

**$entityIds:** `?string` — Filter by file entity IDs

**$dateFrom:** `?int` — dateFrom to date range filter type (timestamp in milliseconds)

**$dateTo:** `?int` — dateTo to date range filter type (timestamp in milliseconds)

**$offset:** `?int` — Index of the first document of the page

**$limit:** `?int` — Number of documents per page

**$sort:** `?string` — Sort the results in the ascending/descending order. Default order is **descending** by creation if `sort` is not passed

$client->files->uploadAFile($request) -> FileData

#### 🔌 Usage

```php $client->files->uploadAFile( new PostCrmFilesRequest([ 'file' => File::createFromString("example_file", "example_file"), ]), ); ```

$client->files->downloadAFile($id) -> GetCrmFilesIdResponse

#### 🔌 Usage

```php $client->files->downloadAFile( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — File id to download.

$client->files->deleteAFile($id)

#### 🔌 Usage

```php $client->files->deleteAFile( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — File id to delete.

$client->files->getFileDetails($id) -> FileData

#### 🔌 Usage

```php $client->files->getFileDetails( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — File id to get file data.

## Notes

$client->notes->getAllNotes($request) -> array

#### 🔌 Usage

```php $client->notes->getAllNotes( new GetCrmNotesRequest([]), ); ```

#### ⚙️ Parameters

**$entity:** `?string` — Filter by note entity type

**$entityIds:** `?string` — Filter by note entity IDs

**$dateFrom:** `?int` — dateFrom to date range filter type (timestamp in milliseconds)

**$dateTo:** `?int` — dateTo to date range filter type (timestamp in milliseconds)

**$offset:** `?int` — Index of the first document of the page

**$limit:** `?int` — Number of documents per page

**$sort:** `?string` — Sort the results in the ascending/descending order. Default order is **descending** by creation if `sort` is not passed

$client->notes->createANote($request) -> PostCrmNotesResponse

#### 🔌 Usage

```php $client->notes->createANote( new NoteData([ 'text' => 'In communication with client_dev for resolution of queries.', ]), ); ```

#### ⚙️ Parameters

**$request:** `NoteData`

$client->notes->getANote($id) -> Note

#### 🔌 Usage

```php $client->notes->getANote( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Note ID to get

$client->notes->deleteANote($id)

#### 🔌 Usage

```php $client->notes->deleteANote( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string` — Note ID to delete

$client->notes->updateANote($id, $request)

#### 🔌 Usage

```php $client->notes->updateANote( 'id', new PatchCrmNotesIdRequest([ 'body' => new NoteData([ 'text' => 'In communication with client_dev for resolution of queries.', ]), ]), ); ```

#### ⚙️ Parameters

**$id:** `string` — Note ID to update

**$request:** `NoteData`

## Tasks

$client->tasks->getAllTasks($request) -> GetCrmTasksResponse

#### 🔌 Usage

```php $client->tasks->getAllTasks( new GetCrmTasksRequest([ 'sortBy' => 'name', ]), ); ```

#### ⚙️ Parameters

**$filterType:** `?string` — Filter by task type (ID)

**$filterStatus:** `?string` — Filter by task status

**$filterDate:** `?string` — Filter by date

**$filterAssignTo:** `?string` — Filter by the "assignTo" ID. You can utilize account emails for the "assignTo" attribute.

**$filterContacts:** `?string` — Filter by contact ids

**$filterDeals:** `?string` — Filter by deals ids

**$filterCompanies:** `?string` — Filter by companies ids

**$dateFrom:** `?int` — dateFrom to date range filter type (timestamp in milliseconds)

**$dateTo:** `?int` — dateTo to date range filter type (timestamp in milliseconds)

**$offset:** `?int` — Index of the first document of the page

**$limit:** `?int` — Number of documents per page

**$sort:** `?string` — Sort the results in the ascending/descending order. Default order is **descending** by creation if `sort` is not passed

**$sortBy:** `?string` — The field used to sort field names.

$client->tasks->createATask($request) -> PostCrmTasksResponse

#### 🔌 Usage

```php $client->tasks->createATask( new PostCrmTasksRequest([ 'date' => new DateTime('2021-11-01T17:44:54Z'), 'name' => 'Task: Connect with client_dev', 'taskTypeId' => '61a5cd07ca1347c82306ad09', ]), ); ```

#### ⚙️ Parameters

**$assignToId:** `?string` — To assign a task to a user you can use either the account email or ID.

**$companiesIds:** `?array` — Companies ids for companies a task is linked to

**$contactsIds:** `?array` — Contact ids for contacts linked to this task

**$date:** `DateTime` — Task due date and time

**$dealsIds:** `?array` — Deal ids for deals a task is linked to

**$done:** `?bool` — Task marked as done

**$duration:** `?int` — Duration of task in milliseconds [1 minute = 60000 ms]

**$name:** `string` — Name of task

**$notes:** `?string` — Notes added to a task

**$reminder:** `?TaskReminder`

**$taskTypeId:** `string` — Id for type of task e.g Call / Email / Meeting etc.

$client->tasks->getATask($id) -> Task

#### 🔌 Usage

```php $client->tasks->getATask( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string`

$client->tasks->deleteATask($id)

#### 🔌 Usage

```php $client->tasks->deleteATask( 'id', ); ```

#### ⚙️ Parameters

**$id:** `string`

$client->tasks->updateATask($id, $request)

#### 🔌 Usage

```php $client->tasks->updateATask( 'id', new PatchCrmTasksIdRequest([]), ); ```

#### ⚙️ Parameters

**$id:** `string`

**$assignToId:** `?string` — To assign a task to a user you can use either the account email or ID.

**$companiesIds:** `?array` — Companies ids for companies a task is linked to

**$contactsIds:** `?array` — Contact ids for contacts linked to this task

**$date:** `?DateTime` — Task date/time

**$dealsIds:** `?array` — Deal ids for deals a task is linked to

**$done:** `?bool` — Task marked as done

**$duration:** `?int` — Duration of task in milliseconds [1 minute = 60000 ms]

**$name:** `?string` — Name of task

**$notes:** `?string` — Notes added to a task

**$reminder:** `?TaskReminder`

**$taskTypeId:** `?string` — Id for type of task e.g Call / Email / Meeting etc.

$client->tasks->getAllTaskTypes() -> GetCrmTasktypesResponse

#### 🔌 Usage

```php $client->tasks->getAllTaskTypes(); ```

## TransactionalWhatsApp

$client->transactionalWhatsApp->sendWhatsappMessage($request) -> SendWhatsappMessageResponse

#### 📝 Description

You can use this API for WhatsApp only if you have setup your WhatsApp account on Brevo platform. To setup your WhatsApp account, follow the steps in the guide below. [Activating Whatsapp](https://developers.brevo.com/docs/whatsapp-campaigns-1) in your account This endpoint is used to send a WhatsApp message.
(**The first message you send using the API must contain a Template ID. You must create a template on WhatsApp on the Brevo platform to fetch the Template ID.**)

#### 🔌 Usage

```php $client->transactionalWhatsApp->sendWhatsappMessage( new SendWhatsappMessageRequestParams([ 'contactNumbers' => [ 'contactNumbers', ], 'senderNumber' => 'senderNumber', 'templateId' => 123, ]), ); ```

#### ⚙️ Parameters

**$request:** `SendWhatsappMessageRequestParams|SendWhatsappMessageRequestText`

$client->transactionalWhatsApp->getWhatsappEventReport($request) -> GetWhatsappEventReportResponse

#### 📝 Description

This endpoint will show the unaggregated statistics for WhatsApp activity (30 days by default if `startDate` and `endDate` or `days` is not passed. The date range can not exceed 90 days)

#### 🔌 Usage

```php $client->transactionalWhatsApp->getWhatsappEventReport( new GetWhatsappEventReportRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number limitation for the result returned

**$offset:** `?int` — Beginning point in the list to retrieve from

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate

**$days:** `?int` — Number of days in the past including today (positive integer). _Not compatible with 'startDate' and 'endDate'_

**$contactNumber:** `?string` — Filter results for specific contact (WhatsApp Number with country code. Example, 85264318721)

**$event:** `?string` — Filter the report for a specific event type

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

## TransactionalEmails

$client->transactionalEmails->getTransacBlockedContacts($request) -> GetTransacBlockedContactsResponse

#### 🔌 Usage

```php $client->transactionalEmails->getTransacBlockedContacts( new GetTransacBlockedContactsRequest([]), ); ```

#### ⚙️ Parameters

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) from which you want to fetch the blocked or unsubscribed contacts

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) till which you want to fetch the blocked or unsubscribed contacts

**$limit:** `?int` — Number of documents returned per page

**$offset:** `?int` — Index of the first document on the page

**$senders:** `?string` — Comma separated list of emails of the senders from which contacts are blocked or unsubscribed

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->transactionalEmails->unblockOrResubscribeATransactionalContact($email)

#### 🔌 Usage

```php $client->transactionalEmails->unblockOrResubscribeATransactionalContact( 'email', ); ```

#### ⚙️ Parameters

**$email:** `string` — contact email (urlencoded) to unblock.

$client->transactionalEmails->getBlockedDomains() -> GetBlockedDomainsResponse

#### 📝 Description

Get the list of blocked domains

#### 🔌 Usage

```php $client->transactionalEmails->getBlockedDomains(); ```

$client->transactionalEmails->blockNewDomain($request)

#### 📝 Description

Blocks a new domain in order to avoid messages being sent to the same

#### 🔌 Usage

```php $client->transactionalEmails->blockNewDomain( new BlockNewDomainRequest([ 'domain' => 'example.com', ]), ); ```

#### ⚙️ Parameters

**$domain:** `string` — name of the domain to be blocked

$client->transactionalEmails->deleteBlockedDomain($domain)

#### 📝 Description

Unblocks an existing domain from the list of blocked domains

#### 🔌 Usage

```php $client->transactionalEmails->deleteBlockedDomain( 'domain', ); ```

#### ⚙️ Parameters

**$domain:** `string` — The name of the domain to be deleted

$client->transactionalEmails->deleteHardbounces($request)

#### 📝 Description

Delete hardbounces. To use carefully (e.g. in case of temporary ISP failures)

#### 🔌 Usage

```php $client->transactionalEmails->deleteHardbounces( new DeleteHardbouncesRequest([]), ); ```

#### ⚙️ Parameters

**$contactEmail:** `?string` — Target a specific email address

**$endDate:** `?string` — Ending date (YYYY-MM-DD) of the time period for deletion. The hardbounces until this date will be deleted. Must be greater than or equal to the startDate

**$startDate:** `?string` — Starting date (YYYY-MM-DD) of the time period for deletion. The hardbounces occurred after this date will be deleted. Must be less than or equal to the endDate

$client->transactionalEmails->sendTransacEmail($request) -> SendTransacEmailResponse

#### 🔌 Usage

```php $client->transactionalEmails->sendTransacEmail( new SendTransacEmailRequest([ 'htmlContent' => '

Hello,

This is my first transactional email sent from Brevo.

', 'sender' => new SendTransacEmailRequestSender([ 'email' => 'hello@brevo.com', 'name' => 'Alex from Brevo', ]), 'subject' => 'Hello from Brevo!', 'to' => [ new SendTransacEmailRequestToItem([ 'email' => 'johndoe@example.com', 'name' => 'John Doe', ]), ], ]), ); ```

#### ⚙️ Parameters

**$attachment:** `?array` — Array of attachment objects. Each attachment must include either an absolute URL (no local file paths) or base64-encoded content, along with the attachment filename. The `name` field is required when `content` is provided. Supported file extensions: xlsx, xls, ods, docx, docm, doc, csv, pdf, txt, gif, jpg, jpeg, png, tif, tiff, rtf, bmp, cgm, css, shtml, html, htm, zip, xml, ppt, pptx, tar, ez, ics, mobi, msg, pub, eps, odt, mp3, m4a, m4v, wma, ogg, flac, wav, aif, aifc, aiff, mp4, mov, avi, mkv, mpeg, mpg, wmv, pkpass, xlsm. When `templateId` is specified: if the template uses the New Template Language format, both `url` and `content` attachment types are supported; if the template uses the Old Template Language format, the `attachment` parameter is ignored.

**$batchId:** `?string` — UUIDv4 identifier for the scheduled batch of transactional emails. If omitted, a valid UUIDv4 batch identifier is automatically generated.

**$bcc:** `?array` — Array of BCC recipient objects. Each object contains an email address and an optional name.

**$cc:** `?array` — Array of CC recipient objects. Each object contains an email address and an optional name.

**$headers:** `?array` — Custom email headers (non-standard headers) to include in the email. The `sender.ip` header can be set to specify the IP address used for sending transactional emails (dedicated IP users only). Header names must use Title-Case-Format (words separated by hyphens with the first letter of each word capitalized). Headers not in this format are automatically converted. Standard email headers are not supported. Example: `{"sender.ip":"1.2.3.4", "X-Mailin-custom":"some_custom_value", "Idempotency-Key":"abc-123"}`

**$htmlContent:** `?string` — HTML body content of the email. Required when `templateId` is not provided. Ignored when `templateId` is provided.

**$messageVersions:** `?array` — Array of message version objects for sending customized email variants. The `templateId` can be customized per version only if a global `templateId` is provided. The `htmlContent` and `textContent` can be customized per version only if at least one of these is present in the global parameters. Global parameters such as `to` (required), `bcc`, `cc`, `replyTo`, and `subject` can be customized per version. Maximum total recipients per API request is 2000. Maximum recipients per message version is 99. Individual `params` objects must not exceed 100 KB. Cumulative `params` across all versions must not exceed 1000 KB. See https://developers.brevo.com/docs/batch-send-transactional-emails for detailed usage instructions.

**$params:** `?array` — Key-value pairs for template variable substitution. Only applicable when the template uses the New Template Language format.

**$replyTo:** `?SendTransacEmailRequestReplyTo` — Reply-to email address (required) and optional display name. Recipients will use this address when replying to the email.

**$scheduledAt:** `?DateTime` — UTC date-time when the email should be sent (format: YYYY-MM-DDTHH:mm:ss.SSSZ). Include timezone information in the date-time value. Scheduled emails may be delayed by up to 5 minutes.

**$sender:** `?SendTransacEmailRequestSender` — Sender information. Required when `templateId` is not provided. Specify either an email address (with optional name) or a sender ID. The `name` field is ignored when `id` is provided.

**$subject:** `?string` — Email subject line. Required when `templateId` is not provided.

**$tags:** `?array` — Array of tags for categorizing and filtering emails

**$templateId:** `?int` — Template identifier

**$textContent:** `?string` — Plain text body content of the email. Ignored when `templateId` is provided.

**$to:** `?array` — Array of recipient objects. Each object contains an email address and an optional display name. Required when `messageVersions` is not provided. Ignored when `messageVersions` is provided. Example: `[{"name":"Jimmy", "email":"jimmy@example.com"}, {"name":"Joe", "email":"joe@example.com"}]`

$client->transactionalEmails->deleteScheduledEmailById($identifier)

#### 📝 Description

Delete scheduled batch of emails by batchId or single scheduled email by messageId

#### 🔌 Usage

```php $client->transactionalEmails->deleteScheduledEmailById( '4320f270-a4e3-4a2e-b591-edfe30a5e627', ); ```

#### ⚙️ Parameters

**$identifier:** `string` — The `batchId` of scheduled emails batch (Should be a valid UUIDv4) or the `messageId` of scheduled email.

$client->transactionalEmails->getScheduledEmailById($identifier, $request) -> GetScheduledEmailByIdResponseBatches|GetScheduledEmailByIdResponseCreatedAt

#### 📝 Description

Fetch scheduled batch of emails by batchId or single scheduled email by messageId (Can retrieve data upto 30 days old)

#### 🔌 Usage

```php $client->transactionalEmails->getScheduledEmailById( '4320f270-a4e3-4a2e-b591-edfe30a5e627', new GetScheduledEmailByIdRequest([ 'startDate' => new DateTime('2022-02-02'), 'endDate' => new DateTime('2022-03-02'), ]), ); ```

#### ⚙️ Parameters

**$identifier:** `string` — The `batchId` of scheduled emails batch (Should be a valid UUIDv4) or the `messageId` of scheduled email.

**$startDate:** `?DateTime` — Mandatory if `endDate` is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Can be maximum 30 days older tha current date.

**$endDate:** `?DateTime` — Mandatory if `startDate` is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month.

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed. Not valid when identifier is `messageId`.

**$status:** `?string` — Filter the records by `status` of the scheduled email batch or message. Not valid when identifier is `messageId`.

**$limit:** `?int` — Number of documents returned per page. Not valid when identifier is `messageId`.

**$offset:** `?int` — Index of the first document on the page. Not valid when identifier is `messageId`.

$client->transactionalEmails->getTransacEmailsList($request) -> GetTransacEmailsListResponse

#### 📝 Description

This endpoint will show the list of emails for past 30 days by default. To retrieve emails before that time, please pass startDate and endDate in query filters.

#### 🔌 Usage

```php $client->transactionalEmails->getTransacEmailsList( new GetTransacEmailsListRequest([]), ); ```

#### ⚙️ Parameters

**$email:** `?string` — **Mandatory if templateId and messageId are not passed in query filters.** Email address to which transactional email has been sent.

**$templateId:** `?int` — **Mandatory if email and messageId are not passed in query filters.** Id of the template that was used to compose transactional email.

**$messageId:** `?string` — **Mandatory if templateId and email are not passed in query filters.** Message ID of the transactional email sent.

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) from which you want to fetch the list. **Maximum time period that can be selected is one month**.

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) till which you want to fetch the list. **Maximum time period that can be selected is one month.**

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

**$limit:** `?int` — Number of documents returned per page

**$offset:** `?int` — Index of the first document in the page

$client->transactionalEmails->getTransacEmailContent($uuid) -> GetTransacEmailContentResponse

#### 📝 Description

You can get the uuid using either of the following methods: Send a GET request to https://api.brevo.com/v3/smtp/emails and pass the message_id in the url. Use your api-key to authenticate the request and you will get your uuid as a response. The uuid can also be fetched from the transactional logs page in your Brevo account, from the address URL.

#### 🔌 Usage

```php $client->transactionalEmails->getTransacEmailContent( 'uuid', ); ```

#### ⚙️ Parameters

**$uuid:** `string` — Unique id of the transactional email that has been sent to a particular contact

$client->transactionalEmails->deleteAnSmtpTransactionalLog($identifier)

#### 🔌 Usage

```php $client->transactionalEmails->deleteAnSmtpTransactionalLog( 'identifier', ); ```

#### ⚙️ Parameters

**$identifier:** `string` — MessageId of the transactional log(s) to delete

$client->transactionalEmails->getAggregatedSmtpReport($request) -> GetAggregatedSmtpReportResponse

#### 📝 Description

This endpoint will show the aggregated stats for past 90 days by default if `startDate` and `endDate` OR `days` is not passed. The date range can not exceed 90 days

#### 🔌 Usage

```php $client->transactionalEmails->getAggregatedSmtpReport( new GetAggregatedSmtpReportRequest([]), ); ```

#### ⚙️ Parameters

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate

**$days:** `?int` — Number of days in the past including today (positive integer). _Not compatible with 'startDate' and 'endDate'_

**$tag:** `?string` — Tag of the emails

$client->transactionalEmails->getEmailEventReport($request) -> GetEmailEventReportResponse

#### 📝 Description

This endpoint will show the aggregated stats for past 30 days by default if `startDate` and `endDate` OR `days` is not passed. The date range can not exceed 90 days

#### 🔌 Usage

```php $client->transactionalEmails->getEmailEventReport( new GetEmailEventReportRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number limitation for the result returned

**$offset:** `?int` — Beginning point in the list to retrieve from.

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate

**$days:** `?int` — Number of days in the past including today (positive integer). _Not compatible with 'startDate' and 'endDate'_

**$email:** `?string` — Filter the report for a specific email addresses

**$event:** `?string` — Filter the report for a specific event type

**$tags:** `?string` — Filter the report for tags (serialized and urlencoded array)

**$messageId:** `?string` — Filter on a specific message id

**$templateId:** `?int` — Filter on a specific template id

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->transactionalEmails->getSmtpReport($request) -> GetSmtpReportResponse

#### 🔌 Usage

```php $client->transactionalEmails->getSmtpReport( new GetSmtpReportRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents returned per page

**$offset:** `?int` — Index of the first document on the page

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date of the report (YYYY-MM-DD)

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date of the report (YYYY-MM-DD)

**$days:** `?int` — Number of days in the past including today (positive integer). _Not compatible with 'startDate' and 'endDate'_

**$tag:** `?string` — Tag of the emails

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->transactionalEmails->postPreviewSmtpEmailTemplates($request) -> PostPreviewSmtpEmailTemplatesResponse

#### 🔌 Usage

```php $client->transactionalEmails->postPreviewSmtpEmailTemplates( [ 'key' => "value", ], ); ```

#### ⚙️ Parameters

**$request:** `mixed`

$client->transactionalEmails->getSmtpTemplates($request) -> GetSmtpTemplatesResponse

#### 🔌 Usage

```php $client->transactionalEmails->getSmtpTemplates( new GetSmtpTemplatesRequest([]), ); ```

#### ⚙️ Parameters

**$templateStatus:** `?bool` — Filter on the status of the template. Active = true, inactive = false

**$limit:** `?int` — Number of documents returned per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->transactionalEmails->createSmtpTemplate($request) -> CreateSmtpTemplateResponse

#### 🔌 Usage

```php $client->transactionalEmails->createSmtpTemplate( new CreateSmtpTemplateRequest([ 'sender' => new CreateSmtpTemplateRequestSender([]), 'subject' => 'Thanks for your purchase !', 'templateName' => 'Order Confirmation - EN', ]), ); ```

#### ⚙️ Parameters

**$attachmentUrl:** `?string` — Absolute url of the attachment (**no local file**). Extension allowed: #### xlsx, xls, ods, docx, docm, doc, csv, pdf, txt, gif, jpg, jpeg, png, tif, tiff, rtf, bmp, cgm, css, shtml, html, htm, zip, xml, ppt, pptx, tar, ez, ics, mobi, msg, pub and eps'

**$htmlContent:** `?string` — Body of the message (HTML version). The field must have more than 10 characters. **REQUIRED if htmlUrl is empty**

**$htmlUrl:** `?string` — Url which contents the body of the email message. REQUIRED if htmlContent is empty

**$isActive:** `?bool` — Status of template. isActive = true means template is active and isActive = false means template is inactive

**$replyTo:** `?string` — Email on which campaign recipients will be able to reply to

**$sender:** `CreateSmtpTemplateRequestSender` — Sender details including id or email and name (_optional_). Only one of either Sender's email or Sender's ID shall be passed in one request at a time. For example: **{"name":"xyz", "email":"example@abc.com"}** **{"name":"xyz", "id":123}**

**$subject:** `string` — Subject of the template

**$tag:** `?string` — Tag of the template

**$templateName:** `string` — Name of the template

$client->transactionalEmails->getSmtpTemplate($templateId) -> GetSmtpTemplateOverview

#### 🔌 Usage

```php $client->transactionalEmails->getSmtpTemplate( 1000000, ); ```

#### ⚙️ Parameters

**$templateId:** `int` — id of the template

$client->transactionalEmails->updateSmtpTemplate($templateId, $request)

#### 🔌 Usage

```php $client->transactionalEmails->updateSmtpTemplate( 1000000, new UpdateSmtpTemplateRequest([]), ); ```

#### ⚙️ Parameters

**$templateId:** `int` — id of the template

**$attachmentUrl:** `?string` — Absolute url of the attachment (**no local file**). Extensions allowed: #### xlsx, xls, ods, docx, docm, doc, csv, pdf, txt, gif, jpg, jpeg, png, tif, tiff, rtf, bmp, cgm, css, shtml, html, htm, zip, xml, ppt, pptx, tar, ez, ics, mobi, msg, pub and eps

**$htmlContent:** `?string` — **Required if htmlUrl is empty**. If the template is designed using Drag & Drop editor via HTML content, then the design page will not have Drag & Drop editor access for that template. Body of the message (HTML must have more than 10 characters)

**$htmlUrl:** `?string` — **Required if htmlContent is empty**. URL to the body of the email (HTML)

**$isActive:** `?bool` — Status of the template. isActive = false means template is inactive, isActive = true means template is active

**$replyTo:** `?string` — Email on which campaign recipients will be able to reply to

**$sender:** `?UpdateSmtpTemplateRequestSender` — Sender details including id or email and name (_optional_). Only one of either Sender's email or Sender's ID shall be passed in one request at a time. For example: **{"name":"xyz", "email":"example@abc.com"}** **{"name":"xyz", "id":123}**

**$subject:** `?string` — Subject of the email

**$tag:** `?string` — Tag of the template

**$templateName:** `?string` — Name of the template

$client->transactionalEmails->deleteSmtpTemplate($templateId)

#### 🔌 Usage

```php $client->transactionalEmails->deleteSmtpTemplate( 1000000, ); ```

#### ⚙️ Parameters

**$templateId:** `int` — id of the template

$client->transactionalEmails->sendTestTemplate($templateId, $request)

#### 🔌 Usage

```php $client->transactionalEmails->sendTestTemplate( 1000000, new SendTestTemplateRequest([ 'body' => new SendTestEmail([]), ]), ); ```

#### ⚙️ Parameters

**$templateId:** `int` — Id of the template

**$request:** `SendTestEmail`

## TransactionalSms

$client->transactionalSms->sendAsyncTransactionalSms($request) -> SendAsyncTransactionalSmsResponse

#### 📝 Description

If the user includes stop code in the Transactional SMS, then it will be switched to Marketing SMS automatically and it will be interpreted as a Marketing SMS. To send Transactional SMS as Transactional, it is important not to use stop code. Note: For adding a stop code, client has to add reply STOP to [STOP_CODE] and the [STOP_CODE] will be replaced with the number. Transactional SMS can be sent at any time without time restrictions. However, if a message is categorized as Marketing, it must adhere to specific time restrictions. Messages sent outside of these restricted hours will experience delays and will be processed during allowable times. Specifically, Marketing SMS cannot be processed between 10pm and 8am, on Sundays, and on French public holidays.

#### 🔌 Usage

```php $client->transactionalSms->sendAsyncTransactionalSms( new SendTransacSms([ 'recipient' => '33689965433', 'sender' => 'MyShop', ]), ); ```

#### ⚙️ Parameters

**$request:** `SendTransacSms`

$client->transactionalSms->sendTransacSms($request) -> SendTransacSmsResponse

#### 🔌 Usage

```php $client->transactionalSms->sendTransacSms( new SendTransacSms([ 'recipient' => '33689965433', 'sender' => 'MyShop', ]), ); ```

#### ⚙️ Parameters

**$request:** `SendTransacSms`

$client->transactionalSms->getTransacAggregatedSmsReport($request) -> GetTransacAggregatedSmsReportResponse

#### 🔌 Usage

```php $client->transactionalSms->getTransacAggregatedSmsReport( new GetTransacAggregatedSmsReportRequest([]), ); ```

#### ⚙️ Parameters

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) of the report

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) of the report

**$days:** `?int` — Number of days in the past including today (positive integer). **Not compatible with startDate and endDate**

**$tag:** `?string` — Filter on a tag

$client->transactionalSms->getSmsEvents($request) -> GetSmsEventsResponse

#### 🔌 Usage

```php $client->transactionalSms->getSmsEvents( new GetSmsEventsRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents per page

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) of the report

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) of the report

**$offset:** `?int` — Index of the first document of the page

**$days:** `?int` — Number of days in the past including today (positive integer). **Not compatible with 'startDate' and 'endDate'**

**$phoneNumber:** `?string` — Filter the report for a specific phone number

**$event:** `?string` — Filter the report for specific events

**$tags:** `?string` — Filter the report for specific tags passed as a serialized urlencoded array

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

$client->transactionalSms->getTransacSmsReport($request) -> GetTransacSmsReportResponse

#### 🔌 Usage

```php $client->transactionalSms->getTransacSmsReport( new GetTransacSmsReportRequest([]), ); ```

#### ⚙️ Parameters

**$startDate:** `?string` — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) of the report

**$endDate:** `?string` — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) of the report

**$days:** `?int` — Number of days in the past including today (positive integer). **Not compatible with 'startDate' and 'endDate'**

**$tag:** `?string` — Filter on a tag

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed

## SmsTemplates

$client->smsTemplates->getSmsTemplates($request) -> GetSmsTemplatesResponse

#### 🔌 Usage

```php $client->smsTemplates->getSmsTemplates( new GetSmsTemplatesRequest([]), ); ```

#### ⚙️ Parameters

**$limit:** `?int` — Number of documents returned per page

**$offset:** `?int` — Index of the first document in the page

**$sort:** `?string` — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed