POST/partners/customers

Adds a customer.

Caution
The productId property includes only the information about the LINE WORKS services.
Support for the productId property is scheduled to end.
In the future, you can add a customer without specifying a subscription and then apply for a subscription using Add a subscription.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

partner

HTTP Request

POSThttps://www.worksapis.com/v1.0/partners/customers

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Request Body

PropertyTypeDescription
domain string 

Domain name.
It can only contain lowercase English letters, numbers, and hyphens. (Note that the name cannot start or end with a hyphen "-", and cannot contain two or more consecutive hyphens.)


required
minLength : 2
maxLength : 22 
productId string 

Plan ID

  • FR: Free
  • STD_T: Standard
  • ADV_T: Advanced

Caution
Support for productId is scheduled to end.


Allowed values : FR, STD_T, ADV_T 
companyName string 

Company/group name


required
maxLength : 40 
phoneNumber string 

Phone number.
Only numbers and PT - * # +, are allowed.


required 
timeZone string 

Time zone code


required 
locale string 

Language code


required
Allowed values : ja_JP, ko_KR, en_US, zh_TW, zh_CN 
administrator object (administrator) 
 
partnership object (partnership) 
 

administrator

PropertyTypeDescription
lastName string 

Last name.
The full name can be up to 80 characters long.
The allowed special characters are ! @ & () - _ + [] {},.


required
maxLength : 80 
firstName string 

First name.
The full name can be up to 80 characters long.
The allowed special characters are ! @ & () - _ + [] {},.

 
password string 

Administrator password.
It must contain alphanumeric characters, and may also include special characters.
Three or more consecutive or repeated letters or numbers are not allowed.
It must be Base64 encoded.


required
minLength : 8
maxLength : 20 
id string 

User ID.
It is a local-part of the email address, like "test" in "test@example.com."
It can only contain alphanumeric characters, ".", "-", and "****_".


required
minLength : 2
maxLength : 40 
privateEmail string 

Personal email address


required 
cellphone string 

Mobile phone number.
Only numbers and PT - * # +, are allowed.

 
countryCode string 

Country code.
It is required if cellphone is specified.

 

partnership

PropertyTypeDescription
enablePartnerProfileDisplay boolean 

Indicates whether to make the partner profile visible.


default : true 

Request Example

example

1{2  "domain": "example.com",3  "productId": "STD_T",4  "companyName": "LINE WORKS Corp.",5  "phoneNumber": "03-0000-0000",6  "timeZone": "Asia/Tokyo",7  "locale": "ja_JP",8  "administrator": {9    "lastName": "Works",10    "firstName": "Administrator",11    "id": "admin",12    "password": "UGFydG5lcjk4IQ==",13    "privateEmail": "private.works@example.com",14    "cellphone": "090-0000-0000",15    "countryCode": "+81"16  },17  "partnership": {18    "enablePartnerProfileDisplay": true19  }20}

Response

HTTP 201

OK

PropertyTypeDescription
tenantId integer 

tenant ID


required
readOnly : true 
domainId integer 

Domain ID


required
readOnly : true 
domain string 

Domain name


required 
productId string 

Plan ID

  • FR: Free
  • STD_T: Standard Trial
  • ADV_T: Advanced Trial
  • STD: Standard
  • ADV: Advanced

Caution
Support for productId is scheduled to end.


Allowed values : FR, STD_T, ADV_T, STD, ADV
nullable : true 
companyName string 

Customer company or organization name


required 
phoneNumber string 

Phone number


required 
timeZone string 

Time zone code


required 
locale string 

Language code


required
Allowed values : ja_JP, ko_KR, en_US, zh_TW, zh_CN 
enableActiveMxrecord boolean 

Indicates whether MX records are active.


required 
enableActiveDomain boolean 

Indicates whether the domain is active (or its ownership is verified).


required 
domainType string 

Domain type

  • DOMAIN: Domain
  • GROUP: Group

required
Allowed values : DOMAIN, GROUP 
administrator object (administrator) 

Administrator information

 
partnership object (partnership) 

Domain information

 

administrator

PropertyTypeDescription
lastName string 

Last name


required 
firstName string 

First name

 
id string 

User ID


required 
privateEmail string 

Personal email address


required
format : email 
cellphone string 

Mobile phone number

 
countryCode string 

Country code

 

partnership

PropertyTypeDescription
status string 

Partner status

  • TRANSFER_READY: Waiting for approval after the customer status changes from an online direct customer to the partner’s.
  • TERMS_AGREEMENT_READY: Before the agreement of terms
  • APPROVED: Partnership established

Allowed values : TRANSFER_READY, TERMS_AGREEMENT_READY, APPROVED 
customerCode string 

Customer code (up to 200 bytes)

 
enablePartnerProfileDisplay boolean 

Indicates whether to make the partner profile visible.

 
memo string 

Memo


maxLength : 700 
enableDeveloperConsoleAccessControl boolean 

Indicates whether to enable access to the Developer Console.

 
enableAdminConsoleAccessControl boolean 

Indicates whether to enable access to the Admin Console.

 
useOptionPlus boolean 

Indicates whether to use Option Plus (Obsolete. Always true).

 

Response Example

example

1{2  "tenantId": 10000001,3  "domainId": 10000001,4  "domain": "example.com",5  "productId": "STD_T",6  "companyName": "LINE WORKS Corp.",7  "phoneNumber": "03-0000-0000",8  "timeZone": "Asia/Tokyo",9  "locale": "ja_JP",10  "enableActiveMxrecord": true,11  "enableActiveDomain": true,12  "domainType": "DOMAIN",13  "administrator": {14    "lastName": "Works",15    "firstName": "Administrator",16    "id": "admin",17    "privateEmail": "private.works@example.com",18    "cellphone": "090-0000-0000",19    "countryCode": "+81"20  },21  "partnership": {22    "status": "TRANSFER_READY",23    "customerCode": "asd123ada11",24    "enablePartnerProfileDisplay": true,25    "memo": "Memo",26    "enableDeveloperConsoleAccessControl": true,27    "enableAdminConsoleAccessControl": true,28    "useOptionPlus": true29  }30}