POST
/
v1
/
customers
curl --request POST \
  --url https://prod01.copilot.fabric.inc/data-subscription/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customerReferenceId": "12345",
  "locale": "en_US",
  "email": "customer@example.com",
  "contactnumber": "+923333709568",
  "firstName": "Pat",
  "middleName": "E",
  "lastName": "Kake",
  "segment": [
    "employee"
  ],
  "employeeId": "345",
  "communicationPreference": {
    "email": true,
    "sms": true
  }
}'
{
  "id": "62cffd65e8d7eb868c6a29d6",
  "customerReferenceId": "12345",
  "locale": "en_US",
  "email": "customer@example.com",
  "contactNumber": "+923333709568",
  "firstName": "Pat",
  "middleName": "E",
  "lastName": "Kake",
  "segment": [
    "employee"
  ],
  "employeeId": "345",
  "communicationPreference": {
    "email": true,
    "sms": true
  },
  "status": "ACTIVE",
  "createdAt": "2021-10-12T21:35:05.756Z",
  "updatedAt": "2021-10-14T05:40:55.997Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
Details of customer being created

Customer details

​
customerReferenceId
string
required

Unique customer reference ID

​
locale
string
required

Customer locale (language_country)

​
email
string
required

Customer's email address

​
firstName
string
required

Customer's first name

​
lastName
string
required

Customer's last name

​
communicationPreference
object
required

Customer's communications preferences

​
contactnumber
string

Customer's contact number

​
middleName
string

Customer's middle name or initial

​
segment
string[]

Customer's segments

​
employeeId
string

Customer employee ID

Response

200
application/json
Request processed successfully

Customer details after creation

​
id
string

Customer ID

​
customerReferenceId
string

Customer reference ID

​
locale
string

Customer locale (language_country)

​
email
string

Customer's email address

​
contactNumber
string

Customer's contact number

​
firstName
string

Customer's first name

​
middleName
string

Customer's middle name or initial

​
lastName
string

Customer's last name

​
segment
string[]

Customer's segments

​
employeeId
string

Customer employee ID

​
communicationPreference
object

Customer's communications preferences

​
status
enum<string>

Customer status

Available options:
ACTIVE,
INACTIVE
​
createdAt
string

Time customer was created

​
updatedAt
string

Most recent time customer was updated

Was this page helpful?

Update single subscriber's shipping and billing informationUpdate single subscriber