Create Account Team
Creates a new team in your account.
Endpoint
PUT
v5/accountteams
Requires authentication
Path Parameters
None
Query Parameters
team_name
string
required
The name for the new team.
description
string
A description for the team.
default_role
integer
The ID of the default role to assign to team members. Standard role IDs range from 2–6.
Response
Returns the newly created team object.
result_ok
boolean
Whether the request succeeded.
data
object
The newly created account team object.
child attributes
id
integer
The unique ID of the newly created team.
team_name
string
The name of the team.
description
string
A description of the team. Null if not set.
default_role
integer
The ID of the default role assigned to team members. Default 0 if not set.
string
The status of the team. Returns
Active for a newly created team.Examples
Request (cURL)
curl -X PUT "https://api.alchemer.com/v5/accountteams?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&team_name=Team+3&description=This+team+will+administer+marketing+surveys"
Response
{
"result_ok": true,
"data": {
"id": 498288,
"team_name": "Team 3",
"description": "This team will administer marketing surveys",
"default_role": null,
"status": "Active"
}
}