Create a new Email Sharing

POST /v1/email_campaigns/{campaign_id}/email_sharings

Authentication

Authentication Method Token token=<API_TOKEN>

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

{
  "emails": [
    "<email>"
  ],
  "custom_attributes": {
    "<recipient>": {
      "name": "<name>",
      "external_id": "<external_id>",
      "phone_number": "<phone_number>"
    }
  },
  "built_in_responses": {
    "<email>": {
      "customerDetailInfo1": "<customerDetailInfo1>",
      "customerDetailInfo2": "<customerDetailInfo2>"
    }
  }
}

Request Body Fields

Field	Type	Required	Description
`emails`	array		Email addresses.
`emails[]`	string		Email address.
`custom_attributes`	object	No	Custom attributes.
`custom_attributes.<recipient>.name`	string		Customer name.
`custom_attributes.<recipient>.external_id`	string		External customer identifier.
`custom_attributes.<recipient>.phone_number`	string		Customer phone number.
`built_in_responses` / `transactional_data`	object	No	Built-in response data associated with each recipient. `transactional_data` is an alternative field name supported by the API.

Request Example

cURL

cURL Request Example

curl --location 'https://<pisanoEnvironment>/v1/email_campaigns/<campaignID>/email_sharings' \
--header 'Authorization: Token token=<API_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
  "emails": [
    "<email>"
  ],
  "custom_attributes": {
    "<recipient>": {
      "name": "<name>",
      "external_id": "<external_id>",
      "phone_number": "<phone_number>"
    }
  },
  "built_in_responses": {
    "<email>": {
      "customerDetailInfo1": "<customerDetailInfo1>",
      "customerDetailInfo2": "<customerDetailInfo2>"
    }
  }
}'

Responses

200 OK (Successful)

Response Fields

Field	Type	Description
`status`	string	Processing status returned for the email sharing request.
`delivery_time`	string	Delivery time returned for the request.
`sidekiq_job_id`	string	Identifier of the background job.
`correlation_id`	string	Identifier used to track and correlate the request.

Response Example

JSON Response Example

{
  "status": "enqueued",
  "delivery_time": "<delivery_time>",
  "sidekiq_job_id": "<sidekiq_job_id>",
  "correlation_id": "<correlation_id>"
}

400 bad_request

{
  "error_message": "string",
  "data": "string",
  "code": 0,
  "errors": [
    {
      "code": "string",
      "message": "string",
      "field": "string"
    }
  ]
}

401 Error: Unauthorized

Error Code: 13001
Error Message: Wrong authentication token

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

403 Error: Forbidden

Error Code: 13013
Error Message: Permission denied

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

404 Requested resource not found!

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.

Usage Limitations

Best practice: trigger no more than 5,000 customers in a single request.

Pisano Campaing Sharing APIs - Email - Email Sharing