# Send SMS Job.

Send one or more SMS with one or more recipients each. The total number of recipients is limited to 3000 per job. The response contains the job ID (jobId) of your new SMS job.

Endpoint: POST /jobs
Version: v1.0.0
Security: httpBasicAuth

## Request fields (application/json):

  - `options` (object)

  - `options.src` (string)
    The Sender ID displayed to recipient.
    Example: "retarus"

  - `options.encoding` (string)
    Enum: "STANDARD", "UTF-16"

  - `options.billcode` (string)
    Max. 70 characters.

  - `options.statusRequested` (boolean)
    Delivery notification requested.

  - `options.flash` (boolean)

  - `options.customerRef` (string)
    Recommended max. 64 characters.

  - `options.validityMin` (integer)
    Validity of the SMS in minutes. When 0 the provider’s default value is used. Otherwise, values must be between 5 and 2880 minutes.

  - `options.maxParts` (integer)
    Maximum allowed parts in a multi-part message. Values must be between 1 and 20. Longer messages are truncated.

  - `options.invalidCharacters` (string)
    Define how to handle invalid characters in SMS.
    Enum: "REFUSE", "REPLACE", "TO_UTF16", "TRANSLITERATE"

  - `options.qos` (string)
    Quality of Service.
    Enum: "EXPRESS", "NORMAL"

  - `options.jobPeriod` (string)
    Timestamp to schedule when to start processing the SMS Job (iso-8601).
    Example: "2018-07-09T11:25:24.683+02:00"

  - `options.duplicateDetection` (boolean)

  - `options.blackoutPeriods` (array)
    Example: ["2018-07-09T10:25:24.683+02:00/2018-07-09T11:25:24.683+02:00"]

  - `messages` (array, required)

  - `messages.text` (string, required)
    foo

  - `messages.recipients` (array, required)

  - `messages.recipients.dst` (string, required)

  - `messages.recipients.customerRef` (string)
    Recommended max. 64 characters. Recipient mobile phone number used as default.

  - `messages.recipients.blackoutPeriods` (array)
    Example: ["2018-07-09T10:25:24.683+02:00/2018-07-09T11:25:24.683+02:00"]

## Response 201 fields (application/json):

  - `jobId` (string)

## Response 400 fields (application/json):

  - `details` (string)

  - `code` (integer)

  - `message` (string)

## Response 409 fields (application/json):

  - `code` (integer)

  - `message` (string)

## Response 422 fields (application/json):

  - `details` (string)

  - `code` (integer)

  - `message` (string)


## Response 401 fields

## Response 429 fields

## Response default fields