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 Integer
user
optional

Value: Must be a Hash
user[first_name]
required

first name of the user


Value: Must be String
user[last_name]
required

last name of the user


Value: Must be String
user[title]
optional

title of the user


Value: Must be String
user[profile_photo_url]
optional

set the profile picture to the picture from this URL link


Value: Must be 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 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 String
user[contact_info][office_phone]
optional

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

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

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

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

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

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

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

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

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

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

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

Value: Must be 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": 10,
    "first_name": "fuzzy",
    "last_name": "monkey",
    "name": "fuzzy monkey",
    "html_name": "fuzzy monkey",
    "url": "https://socialcast.socialcast.test/users/10-fuzzymonkey",
    "avatars": {
      "is_system_default": false,
      "id": 1,
      "square16": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/1/rails_square16.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20170222%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170222T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=8967bee0818c42110a0eb7fcb890009445f4af3b901545cf8393d21a8d3d4777",
      "square30": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/1/rails_square30.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20170222%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170222T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=7cceb71d3e920e749f77cee0621ee2a24c70aa5f1981e899b656e4a2420f630d",
      "square45": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/1/rails_square45.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20170222%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170222T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=2a9152a57e3bccf111b66356eb95a542da154a6196baffb2d2dab28cc8950fdb",
      "square70": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/1/rails_square70.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20170222%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170222T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=471dbf8f3a975f4c8a2f478ac78b7dd650b1256f797e0b78cc65b6282288b642",
      "square140": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/1/rails_square140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20170222%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170222T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=2350240cfee43785735d7e31e59f1f6436d33be6e8ea726657649897080130d5",
      "original": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/1/rails.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20170222%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170222T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=768a8ece3639b57a399b49d9bc878b6b3c907459bebc9bd690aec0f568a5a232"
    },
    "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
  }
}