API Reference
Monta.com

Patch an existing team

patch
https://partner-api.monta.com/api/v1/teams/

Required scope: teams:write
Organization authorization: supported

Note: To update the operator team status, use the dedicated PATCH /teams/{id}/operator-team endpoint instead.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required
Body Params
int64 | null

Id of the user that owns the team

string | null

email of the user that owns the team, useful when the userId is not known

string | null

Name of the team

string | null

Contact email of the team. Named "email" in the GET APIs.

string | null

Finance contact email of the team

string | null

Recipient for important payment notices (late payment, freeze warning, frozen). When not set, these go to financeEmail.

string | null

Legal contact email of the team.

address
object | null

Address of the team. Only countryId is mandatory. Address1, city, and zipCode must be provided together or all left null.

string | null

The company name for the team

string | null

The vat number for the team

string | null

The company registration number for the team

string | null

External Id of this entity, managed by you.

partnerCustomPayload
object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

string | null
enum

The payment method for the team

Allowed:
int32 | null

The theme id to assign to the team.
Note: When theme is provided, it must belong to the same operator as the team

onboardingSteps
array of objects | null

The onboarding steps enabled for the team, as {step, config?, displayMode?} entries. Sending the list replaces the full enabled set; omitting it leaves the steps unchanged.

onboardingSteps
onboardingWelcomeText
object | null

The app-onboarding welcome-screen text override. Sending it replaces the saved override (slots required; {} clears them); omitting it leaves it unchanged. Send enabled: false to revert to Monta's default copy. Rejected with 409 while the team is linked to an onboarding profile.

string | null

Category identifier of the team, one of: housing-association, cpo, parking, hotel, fleet, company, priced-by-site-owner.
Note: omit the field to leave the category unchanged.

boolean | null

Whether the team is restricted to only charge keys that are in the operator inventory

int32 | null

The cost center id to assign to the team.
Note: Send null to clear the assignment; omit the field to leave it unchanged.

int32 | null

Account template the team follows, from GET /operator-team-settings. The template supplies the team's default price groups, so pinning one is how an operator-owned tariff becomes a team default.
Note: Send null to unpin the team; omit the field to leave it unchanged.

int32 | null

Onboarding profile to lock the team to, from GET /onboarding-profiles. Copies the profile's steps onto the team; while assigned, onboardingSteps cannot be edited.
Note: Send null to detach and keep the current steps (editable again); omit the field to leave it unchanged.

Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?