Create a New SMS Sharing

Create a new SMS Sharing.

POST /v1/sms_campaigns/{campaign_id}/sms_sharings

Authentication

Authentication Method API token via Authorization header

Request

Path Parameters

Parameter	Type	Required	Description	Example
`campaign_id`	string($uuid)	Yes	Campaign ID	`campaign_id`

Headers

Header	Required	Description	Example
`Content-Type`	Yes	Request content type.	`application/json`
`Authorization`	Yes	Pisano API token.	`Token token=<API_TOKEN>`

Request Body

{
  "phone_numbers": [
    "<phone>"
  ],
  "custom_attributes": {
    "<phone>": {
      "<name>": "<name>",
      "external_id": "<external_id>",
      "email": "<email>"
    }
  },
  "built_in_responses": {
    "<phone>": {
      "customerDetailInfo1": "<customerDetailInfo1>",
      "customerDetailInfo2": "<customerDetailInfo2>"
    }
  }
}

Request Body Fields

Field	Type	Required	Description	Example
`phone_numbers[]`				`<phone>`
`custom_attributes.<phone>.<name>`				`<name>`
`custom_attributes.<phone>.external_id`				`<external_id>`
`custom_attributes.<phone>.email`				`<email>`
`built_in_responses.<phone>.customerDetailInfo1`				`<customerDetailInfo1>`
`built_in_responses.<phone>.customerDetailInfo2`				`<customerDetailInfo2>`

Request Example

cURL

cURL Request Example

curl --location 'https://<pisanoEnvironment>/v1/sms_campaigns/<campaignID>/sms_sharings' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data '{"phone_numbers":["<phone>"],"custom_attributes":{},"built_in_responses":{}}'

Responses

200 OK

OK (Successful)

400 Bad Request

An error occured.

Error Code: 13000
Error Message: An error occured.

{"error_message":"An error occured","data":"An error occured","code":13000}

401 Unauthorized

Wrong authentication token.

Error Code: 13001
Error Message: Wrong authentication token.

{"error_message":"Wrong authentication token","data":"Wrong authentication token","code":13001,"errors":null}

403 Forbidden

Permission denied.

Error Code: 13013
Error Message: Permission denied.

{"error_message":"Permission denied","data":"Permission denied","code":13013,"errors":null}

404 Requested resource not found!

Additional Information

Rate Limits	20 requests/5 sec; 40/25 sec; 80/125 sec; 160/625 sec. On-premise throttle rules can be adjusted or removed.
Pagination
Usage Limitations	Best practice: trigger no more than 5,000 customers in a single request.
Notes
Related APIs

Pisano Campaing Sharing APIs - SMS - SMS Sharing