This method allows you to create a new user within your account. This method is different depending on whether you use the cloud edition or the download edition. With the cloud edition, when you create a user you will automatically email them an invitation which they must accept before they can sign up whereas the download edition you just create the account directly.

URL

/api/v2/users/create

Supported Parameters

• email_address - the e-mail address of the user you are creating (required)
• first_name - the first name of the user (required)
• last_name - the last name of the user (required)
• time_zone - the user's time zone (optional, defaults to UTC)
• job_title - the user's job title (optional)
• admin_access - true or false depending on whether you wish to grant access to the admin interface
• reporting_access - true or false depending on whether you wish to grant access to the reporting interface
• tickets_access - true or false depending on whether you wish to grant access to the tickets interface
• contacts_access - true or false depending on whether you wish to grant access to the contacts interface
• api_allowed - true or false depending on whether you wish to allow access to the API for this user
• restrictions - an array of restrictions which should be applied to this user (available restrictions can be found at the bottom of this page)
• team_ids - an array of team IDs which this user should be assigned to

The follow two parameters are only appropriate in the download edition:

• username - a username for the user (required)
• password - a password for the user (required)

Example Data

Successful Creation

{
  "id": 12,
  "username": "steve",
  "first_name": "Adam",
  "last_name": "Cooke",
  "email_address": "test2@atechmedia.com",
  "time_zone": "UTC",
  "created_at": "2012-03-19T16:18:20+00:00",
  "job_title": "Managing Director",
  "permissions": {
    "admin": false,
    "reporting": false,
    "tickets": true,
    "api": true
  },
  "restrictions": [
    "tickets.deletion"
  ]
}

Validation Error

{
  "email_address": [
    "can't be blank",
    "is invalid"
  ],
  "first_name": [
    "can't be blank"
  ],
  "last_name": [
    "can't be blank"
  ],
  "username": [
    "can't be blank"
  ],
  "password": [
    "can't be blank"
  ]
}

Available user restrictions

• tickets.team_only - Do not allow access to tickets unless they belong to a user's team
• tickets.deletion- Do not allow ticket deletion
• tickets.sla - Do not allow direct changes to a ticket's SLA
• tickets.extended_contact_data- Do not allow access to extended contact data
• tickets.allow_contact - Do not allow direct communication with contacts
• tickets.custom_filter- Do not allow user to make custom filters
• tickets.remove_checklist - Do not allow user to remove checklists from tickets
• tickets.ticket_update_privatisation - Do not allow user to privatise other user's ticket updates
• tickets.blacklisted_attachments- Do not allow user to view blacklisted attachments