CTIX
Network live
CTIXPOST

Create Email Message SCO

Source docs
POSThttps://cs-testv2.cyware.com/ctixapi/conversion/shareable-intel/{intel-id}/email-message/

Creates an email message SCO in the detailed STIX form submission.

Path Parameters

NameTypeRequiredDescription
intel-idstringoptional

Pass the unique ID of the intel submission.

Body Parameters

NameTypeRequiredDescription
custom_propertiesobjectoptional

Pass the list that contains the unique identifier for the custom property, type, name, and the value to add for the same.

tlpobjectoptional

Pass the TLP of the SCO.

defangedbooleanoptional

Pass true if the value specified by the user is defanged, else pass false.

subjectstringrequired

Specifies the subject of the email message.

bodystringrequired

Specifies a string containing the email body.

content_typestringoptional

Specifies the value of the "Content-Type" header of the email message.

datenumberoptional

Specifies the date/time that the email message was sent.

message_idstringoptional

Specifies the Message-ID field of the email message.

Run it

Use the Request parameters panel to enter path IDs, query values, JSON body, and credentials. Then run any snippet below — all languages use the same values. Base URL: https://cs-testv2.cyware.com/ctixapi (change in API Settings).

Playground

Request parameters

Edit values here before running any snippet below (cURL, JavaScript, or Python). Code blocks are reference only — your inputs above are what gets sent.

CTIXConnect to Intel ExchangeRequired to change data
Credentials required for POST

Open API (HMAC signature) · Get credentials from Cyware Admin → Open API → Generate Credentials.

Signature and Expires are generated when you run a request. Access ID and Secret Key stay in memory for this tab only.

Credentials from Authentication auto-fill here for this product. If fields are empty after connecting, refresh this page or open the product docs again.

Path Parameters
Request body (JSON)Valid JSON
cURL
curl --request POST \
  --url "https://cs-testv2.cyware.com/ctixapi/conversion/shareable-intel/{intel-id}/email-message/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E" \
  --data '{
  "custom_properties": {},
  "tlp": {},
  "defanged": false,
  "subject": "sub",
  "body": "body tex",
  "content_type": "application/json",
  "date": 1630434600,
  "message_id": "123"
}'

View-only example — running live API calls requires a role with snippet testing access.

JavaScript
const url = "https://cs-testv2.cyware.com/ctixapi/conversion/shareable-intel/{intel-id}/email-message/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E";

const response = await fetch(url, {
  method: "POST",
  headers: {},
  body: JSON.stringify({
    "custom_properties": {},
    "tlp": {},
    "defanged": false,
    "subject": "sub",
    "body": "body tex",
    "content_type": "application/json",
    "date": 1630434600,
    "message_id": "123"
  }),
});

const text = await response.text();
let data;
try { data = JSON.parse(text); } catch { data = text; }
console.log(response.status, data);

View-only example — running live API calls requires a role with snippet testing access.

Python
import requests

url = "https://cs-testv2.cyware.com/ctixapi/conversion/shareable-intel/{intel-id}/email-message/"
params = {
    "AccessID": "<your access id>",
    "Signature": "<your signature>",
    "Expires": "<your expires>"
}
headers = {}
payload = {
  "custom_properties": {},
  "tlp": {},
  "defanged": false,
  "subject": "sub",
  "body": "body tex",
  "content_type": "application/json",
  "date": 1630434600,
  "message_id": "123"
}
response = requests.request("POST", url, params=params, headers=headers, json=payload)
print(response.status_code)
print(response.text)

View-only example — running live API calls requires a role with snippet testing access.

Request Body
{
  "custom_properties": {},
  "tlp": {},
  "defanged": false,
  "subject": "sub",
  "body": "body tex",
  "content_type": "application/json",
  "date": 1630434600,
  "message_id": "123"
}

View-only example — running live API calls requires a role with snippet testing access.

Example Response
{
  "id": "email-message--b2f3ffbf-3840-4ddb-a5cd-5e7da0fd564d",
  "tlp": {},
  "custom_properties": {},
  "name": "sub",
  "defanged": false,
  "body": "body tex",
  "subject": "sub",
  "date": 1630434600,
  "content_type": "application/json",
  "message_id": "123"
}

View-only example — running live API calls requires a role with snippet testing access.