POST /api/users

create a user as a community admin

Success Response Code: 201

Params

Param name Description
activate_user
optional

activate the user or not (default=false)


Value: Must be one of: <code>true</code>, <code>false</code>.
skip_emails
optional

skip new user emails (default=false)


Value: Must be one of: <code>true</code>, <code>false</code>.
skip_joined_notifications
optional

Do not send the user a welcome email or post a welcome message to the stream on their behalf (only effective when activate_user is also true) (default=false)


Value: Must be one of: <code>true</code>, <code>false</code>.
account_type
optional

Whether this user will be a standard member or external contributor (default=member)


Value: Must be one of: <code>member</code>, <code>external</code>.
group_id
optional

If this user is an external contributor, the group that they will be allowed to interact with (required for external contributors)


Value: Must be a Integer
user
optional

Value: Must be a Hash
user[first_name]
required

first name of the user


Value: Must be a String
user[last_name]
required

last name of the user


Value: Must be a String
user[title]
optional

title of the user


Value: Must be a String
user[profile_photo_url]
optional

set the profile picture to the picture from this URL link


Value: Must be a String
user[profile_photo]
optional

Value: Must be a Hash
user[profile_photo][data]
optional

set the profile picture to a file upload from the local file path


Value: Must be a File
user[roles]
optional

Value: Must be a Hash
user[roles][tenant_admin_role]
optional

flag to set tenant admin role


Value: Must be one of: <code>true</code>, <code>false</code>.
user[contact_info]
optional

Value: Must be a Hash
user[contact_info][cell_phone]
optional

Value: Must be a String
user[contact_info][office_phone]
optional

Value: Must be a String
user[contact_info][aim]
optional

Value: Must be a String
user[contact_info][google_talk]
optional

Value: Must be a String
user[contact_info][yahoo]
optional

Value: Must be a String
user[contact_info][skype]
optional

Value: Must be a String
user[contact_info][jabber]
optional

Value: Must be a String
user[contact_info][msn]
optional

Value: Must be a String
user[contact_info][email]
required

Value: Must be a String
user[contact_info][location]
optional

Value: Must be a String
user[contact_info][twitter]
optional

Value: Must be a String
user[contact_info][lync]
optional

Value: Must be a String
user[contact_info][google_talk]
optional

Value: Must be a String

Response Fields

user see #show for details User

Example Curl Commands

curl -X POST -v --basic -u "admin@socialcast.com:password" 'https://demo.socialcast.com/api/users' -H"Content-Type: application/json" -d'{"user": { "first_name":"Emily2", "last_name":"James", "contact_info": { "email": "emily2@socialcast.com" }}}'

Examples

POST /api/users.json
{
  "user": {
    "contact_info": {
      "email": "monkey@socialcast.com"
    },
    "first_name": "fuzzy",
    "last_name": "monkey"
  }
}
201
{
  "user": {
    "contact_info": {
      "email": "monkey@socialcast.com"
    },
    "manager": null,
    "custom_fields": [],
    "followable": false,
    "contact_id": null,
    "following_count": 0,
    "followers_count": 0,
    "status_message": null,
    "id": 57,
    "first_name": "fuzzy",
    "last_name": "monkey",
    "name": "fuzzy monkey",
    "html_name": "fuzzy monkey",
    "url": "https://socialcast.socialcast.test/users/57-fuzzymonkey",
    "avatars": {
      "is_system_default": false,
      "id": 4,
      "square16": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square16.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180521%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180521T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=de88f354d1ed33e90bf8513b413441c2723f94e50b091a14a802a405a320d69c",
      "square30": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square30.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180521%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180521T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=669c7d6f55d9bf41fad79f823c97bd8b44156920bdd2d34a42510d462222fefa",
      "square45": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square45.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180521%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180521T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=e6a889d1d3bdda135550a466b53305faed457f9ed97a4bb8f4700069551729ea",
      "square70": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square70.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180521%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180521T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=fe03e35d528534fa024be0d44193cbde98fce2179894b445ed4f3ba1d7f0c886",
      "square140": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180521%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180521T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=159c4678ad71e4a633a4f80dd30e888927fd481e9654fe8b7ce70d7c25bc44d8",
      "original": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180521%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180521T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=4087a3309e891d581bdb39d353e629ad1cccd98e93dde9eedcdc54df6ebaa7e2"
    },
    "username": "fuzzymonkey",
    "active": false,
    "terminated": false,
    "inactive": true,
    "role": "member",
    "type": "User",
    "title": null,
    "out_of_office": false,
    "out_of_office_on": null,
    "back_in_office_on": null,
    "company_login": null
  }
}