Create User

{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"optional","results":{"codes":[{"language":"text","code":""}]},"settings":"57ee593a21ceb20e0061959e","params":[],"examples":{"codes":[]},"method":"post"},"next":{"description":"","pages":[]},"title":"Create User","type":"endpoint","slug":"create-user-api","excerpt":"","body":"##Definition\nhttps://sandbox.bluesnap.com/services/2/cp/user?onbehalfofmid=\n\n<hr>\n\n##Documentation\n\nThe BlueSnap Create User API is a RESTful web service enabling you to create a user in your BlueSnap account or any of your linked accounts. After creating your user, that user will have access to the Merchant Portal.\n\n###Request Content\n\nSend a JSON object, with the following:\n\n      `firstName`     *string*    **required**\n\n      `lastName`     *string*    **required**\n\n      `email`     *string*    **required**\n\n      `username`     *string*    **required**\n\n      `password`     *string*    optional (if empty, a new password is generated)\n[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Note:\",\n \"body\": \"Any of the permissions described in [User Permissions](doc:user-permissions) can be included with a value of \\\"true.\\\"\"\n}\n[/block]\n<hr>\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the user's attributes, one of which is the ID. \nThe `userId` appears in the response body and the location header.\n\n<hr>\n\n##Examples\n\n###Request Example\n[block:callout]\n{\n \"type\": \"info\",\n \"body\": \"If you need to manage an operation on behalf of a linked BlueSnap account, use the \\\"onbehalfofmid\\\" parameter.\",\n \"title\": \"Note:\"\n}\n[/block]\n\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/cp/user \\\\\\n-H 'Content-Type: application/json' \\n-H 'Accept: application/json' \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\\n{\\n \\\"firstName\\\": \\\"New\\\",\\n \\\"lastName\\\": \\\"User\\\",\\n \\\"email\\\": \\\"new.user:::at:::email.com\\\",\\n \\\"username\\\": \\\"finance1234\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"Create User\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/cp/user \\\\\\n-H 'Content-Type: application/json' \\n-H 'Accept: application/json' \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\\n{\\n \\\"firstName\\\": \\\"New\\\",\\n \\\"lastName\\\": \\\"User\\\",\\n \\\"email\\\": \\\"[email protected]\\\",\\n \\\"username\\\": \\\"finance1234\\\",\\n \\\"password\\\": \\\"[email protected]\\\",\\n \\\"admin\\\": \\\"true\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"Create User with Permission\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/cp/user?onbehalfofmid=12345\\n-H 'Content-Type: application/json' \\n-H 'Accept: application/json' \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\\n{\\n \\\"firstName\\\": \\\"New\\\",\\n \\\"lastName\\\": \\\"User\\\",\\n \\\"email\\\": \\\"[email protected]\\\",\\n \\\"username\\\": \\\"finance1234\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"Create User on behalf of linked BlueSnap account\"\n }\n ]\n}\n[/block]\n###Response Example\n\nIf successful, the response HTTP status code is 200 OK. \n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"userId\\\": \\\"1111001\\\",\\n \\\"firstName\\\": \\\"New\\\",\\n \\\"lastName\\\": \\\"User\\\",\\n \\\"email\\\": \\\"[email protected]\\\",\\n \\\"username\\\": \\\"finance1234\\\",\\n \\\"admin\\\": \\\"true\\\"\\n}\",\n \"language\": \"json\",\n \"name\": \"Create User Response: 200 OK\"\n }\n ]\n}\n[/block]\n##Example Descriptions\n\nFor details about the above examples, see:\n\n* [Create User](https://developers.bluesnap.com/v8976-Tools/docs/create-user-api#section-create-user)\n* [Create User with permission](https://developers.bluesnap.com/v8976-Tools/docs/create-user-api#section-create-user-with-permission)\n* [Create User on behalf of linked BlueSnap account](https://developers.bluesnap.com/v8976-Tools/docs/create-user-api#section-create-user-on-behalf-of-linked-bluesnap-account)\n\n###Create User\nThis example shows a Create User request with the `firstName`, `lastName`, `email`, and `username` values set. You will want to use these values to define your user's information.\n\n###Create User with permission\nThis example shows a Create User request with the `admin` permissions value set to \"true\".\n\n###Create User on behalf of linked BlueSnap account\nThis example shows a Create User request on behalf of a linked BlueSnap account.\n\n###Parameter Reference\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Parameter\",\n \"h-1\": \"Description\",\n \"0-0\": \"onbehalfofmid\",\n \"0-1\": \"Creates, updates, retrieves, or deletes users on behalf of a linked BlueSnap account\\n\\n**Note:** This parameter specifies the ID of the BlueSnap account that owns the user, which should be linked to the BlueSnap account executing the call.\",\n \"3-0\": \"email\",\n \"3-1\": \"Consists of 4 to 100 characters\",\n \"6-1\": \"If sent, value should be **true **or **false **(otherwise, WS call fails)\\n\\n**Note:** This is an optional setting. Can be used to include as many permissions as necessary.\",\n \"6-0\": \"permissions\",\n \"2-0\": \"lastName\",\n \"2-1\": \"Consists of 2 to 100 characters\\n\\n**Note:** Cannot contain the following symbols: <>!\",\n \"4-0\": \"username\",\n \"4-1\": \"Unique name per BlueSnap account, consisting of 4 to 20 characters \\n\\n**Note:** This name *must* begin with a letter, followed by any letter, number, or dot combination.\",\n \"5-0\": \"password\",\n \"5-1\": \"Consists of 6 to 20 characters, in any letter or number combination; allowed characters: a-z A-Z 0-9 [email protected]#&$%^*()|'-\",\n \"1-0\": \"firstName\",\n \"1-1\": \"Consists of 2 to 100 characters\\n\\n**Note:** Cannot contain the following symbols: <>!\"\n },\n \"cols\": 2,\n \"rows\": 7\n}\n[/block]","updates":["62875bf557ee1902231ff397"],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"6197defc41c8040154bcbaa1","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-Tools","version_clean":"8976.0.0-Tools","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6197defc41c8040154bcba61","6197defc41c8040154bcba62","6197defc41c8040154bcba63","6197defc41c8040154bcba64","6197defc41c8040154bcba65","6197defc41c8040154bcba66","6197defc41c8040154bcba67","6197defc41c8040154bcba68","6197defc41c8040154bcba69","6197defc41c8040154bcba6a","6197defc41c8040154bcba6b","6197defc41c8040154bcba6c","5b34c737e0dca2000311de6a","60957f4cce403c0045a031ef","6197defc41c8040154bcba6d","6197defc41c8040154bcba6e","6197defc41c8040154bcba6f","6197defc41c8040154bcba70","6197defc41c8040154bcba71","6197defc41c8040154bcba72"],"_id":"6197defc41c8040154bcbaea","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60957f4cce403c0045a03255","createdAt":"2018-04-23T15:17:35.680Z","releaseDate":"2018-04-23T15:17:35.680Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"User Management","slug":"merchant-single-signon","order":17,"from_sync":false,"reference":false,"_id":"6197defc41c8040154bcba6c","project":"57336fd5a6a9c40e00e13a0b","version":"6197defc41c8040154bcbaea","createdAt":"2018-06-18T14:13:01.902Z","__v":0},"user":"5b155c2c3fbcd30003e76908","createdAt":"2018-06-18T14:14:32.641Z","githubsync":"","__v":79,"parentDoc":null}

Definition

https://sandbox.bluesnap.com/services/2/cp/user?onbehalfofmid=

Documentation

The BlueSnap Create User API is a RESTful web service enabling you to create a user in your BlueSnap account or any of your linked accounts. After creating your user, that user will have access to the Merchant Portal.

Request Content

Send a JSON object, with the following:

firstName string required

lastName string required

email string required

username string required

password string optional (if empty, a new password is generated)

Note:

Any of the permissions described in User Permissions can be included with a value of "true."

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the user's attributes, one of which is the ID.
The userId appears in the response body and the location header.

Examples

Request Example

Note:

If you need to manage an operation on behalf of a linked BlueSnap account, use the "onbehalfofmid" parameter.

Create User

Create User with Permission

Create User on behalf of linked BlueSnap account

curl -v -X POST https://sandbox.bluesnap.com/services/2/cp/user \
-H 'Content-Type: application/json' 
-H 'Accept: application/json' 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
{
  "firstName": "New",
  "lastName": "User",
  "email": "[email protected]",
  "username": "finance1234"
}'

curl -v -X POST https://sandbox.bluesnap.com/services/2/cp/user \
-H 'Content-Type: application/json' 
-H 'Accept: application/json' 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
{
  "firstName": "New",
  "lastName": "User",
  "email": "[email protected]",
  "username": "finance1234",
  "password": "[email protected]",
  "admin": "true"
}'

curl -v -X POST https://sandbox.bluesnap.com/services/2/cp/user?onbehalfofmid=12345
-H 'Content-Type: application/json' 
-H 'Accept: application/json' 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
{
  "firstName": "New",
  "lastName": "User",
  "email": "[email protected]",
  "username": "finance1234"
}'

Response Example

If successful, the response HTTP status code is 200 OK.

Create User Response: 200 OK

{
  "userId": "1111001",
  "firstName": "New",
  "lastName": "User",
  "email": "[email protected]",
  "username": "finance1234",
  "admin": "true"
}

Example Descriptions

For details about the above examples, see:

This example shows a Create User request with the firstName, lastName, email, and username values set. You will want to use these values to define your user's information.

Create User with permission

This example shows a Create User request with the admin permissions value set to "true".

Create User on behalf of linked BlueSnap account

This example shows a Create User request on behalf of a linked BlueSnap account.

Parameter Reference

Parameter

Description

onbehalfofmid

Creates, updates, retrieves, or deletes users on behalf of a linked BlueSnap account

Note: This parameter specifies the ID of the BlueSnap account that owns the user, which should be linked to the BlueSnap account executing the call.

firstName

Consists of 2 to 100 characters

Note: Cannot contain the following symbols: <>!

lastName

Consists of 2 to 100 characters

Note: Cannot contain the following symbols: <>!

Consists of 4 to 100 characters

username

Unique name per BlueSnap account, consisting of 4 to 20 characters

Note: This name must begin with a letter, followed by any letter, number, or dot combination.

password

Consists of 6 to 20 characters, in any letter or number combination; allowed characters: a-z A-Z 0-9 [email protected]#&$%^*()|'-

permissions

If sent, value should be true or false (otherwise, WS call fails)

Note: This is an optional setting. Can be used to include as many permissions as necessary.

Developer Hub

BlueSnap Reporting & Tools

Reporting API

Custom Reporting API

3D Secure

Account Updater

Bank Directory

Convert Currency

Encrypt/Decrypt Parameters

Hosted Payment Fields

Logos & Images

Payment Request Button

Retrieve Card Info

Retrieve Payment Methods

Secured Payment Collector

SEPA Direct Debit

Tax Quotes

User Management

Wallets

postCreate User

Definition

Documentation

Request Content

Note:

Response Details

Examples

Request Example

Note:

Response Example

Example Descriptions

Create User

Create User with permission

Create User on behalf of linked BlueSnap account

Parameter Reference