---
title: "Create Subscriber"
method: POST
path: "/subscribers"
tags: ["Subscribers"]
---

# Create Subscriber

`POST /subscribers`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/subscribers`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/subscribers/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns success result

## Request body

- ServiceChannelServicesMessagingSubscribersRegisterSubscriberRequest: RegisterSubscriberRequest
  - `Name` string, required: Required Name Name - name of the subscriber
  - `Address1` string, required: Subscriber Address1
  - `Address2` string: Subscriber Address2
  - `Country` string, required: Subscriber Country
  - `State` string, required: Subscriber State
  - `City` string, required: Subscriber City
  - `Zip` string, required: Subscriber Zip
  - `Email` string, required: Subscriber Email
  - `Phone` string, required: Subscriber Phone
  - `Fax` string: Subscriber Fax
  - `ContactName` string: Subscriber ContactName
  - `TaxId` string, required: TaxId
  - `IsPersonalTaxId` boolean, required: IsPersonalTaxId
  - `SysadminContactFixxbook` ServiceChannelServicesMessagingSubscribersSysadminContactFixxbook: SysadminContactFixxbook
    - `Name` string: Name
    - `JobTitle` string: JobTitle
    - `Email` string: Email is used for Login in Fixxbook
    - `WorkPhone` string: WorkPhone
    - `MobilePhone` string: MobilePhone
    - `Fax` string: Fax
  - `TimeFormat` string
  - `DateFormat` string
  - `DecimalSeparator` string

## Response `201`

Indicates that the request succeeded and that a new Subscriber is created.

## Other responses

- `400`: Bad Request - the request could not be understood or was missing required parameters.
- `401`: Indicates that the requested resource requires authentication.<br>Error codes:<br> 504 - API call rejected by security permissions;
- `500`: Indicates that an error has occured wile creation of a new Subscriber.

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)