Create an outbound message

post

/crmRestApi/resources/11.13.18.05/outboundMessages

Request

Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Alternate Message ID
    Maximum Length: 2000
    The unique identifier of the outbound email in the email delivery application.
  • Title: Body
    The body of the outbound message.
  • Title: Business Organization ID
    The unique identifier of the business unit organization Id.
  • Title: Channel ID
    The unique identifier of the channel of the outbound Message.
  • Title: Channel Type Code
    Maximum Length: 30
    The channel type code.
  • Title: Corporate Currency Code
    Maximum Length: 15
    The corporate currency code associated with the outbound message. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Type of Currency Conversion Rate
    Maximum Length: 30
    The currency conversion rate type associated with the outbound message. A list of valid values are defined in the lookup ZCA_COMMON_RATE_TYPE. Review and update the profile option using the Setup and Maintenance work area, Manage Currency Profile Options task.
  • Title: Currency Code
    Maximum Length: 15
    The currency code associated with the outbound message. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Delivery Type Code
    Maximum Length: 30
    Default Value: ORA_SVC_IMMEDIATE
    The delivery type code of the outbound message.
  • Title: Message Content
    The content of the outbound message, such as the contents of an email.
  • Title: Outbound Message ID
    The unique identifier of the outbound message.
  • Title: Outbound Message Number
    Maximum Length: 30
    The alternate key identifier of the outbound message.
  • Outbound Message Parts
    Title: Outbound Message Parts
    The outbound message parts resource is used to view, create, update, and delete an outbound message part. It's used to get the description of the root outbound message resource part.
  • Title: Posted by Party ID
    The unique party identifier of the user who posted the outbound message.
  • Title: Processing Status Code
    Maximum Length: 30
    The processing status code of the outbound message.
  • Title: Reply to Address
    Maximum Length: 240
    The reply to address of the outbound message.
  • Title: Retry Count
    Default Value: 0
    The retry count of the outbound message.
  • Title: Sender Email Source Code
    Maximum Length: 30
    The source code of the sender email for the outbound message.
  • Title: Sender Name
    Maximum Length: 100
    The name of the sender who sent the outbound message.
  • Title: Sent Date
    The date when the message was sent by the sender.
  • Title: Source Code
    Maximum Length: 30
    The source code of the outbound message.
  • Title: Source Message Object ID
    The object identifier of the outbound message.
  • Title: Source Message Object Type Code
    Maximum Length: 30
    The source message object type code of the outbound message.
  • Title: Source Object ID
    The source object identifier of the outbound message.
  • Title: Source Object Primary Key Name
    Maximum Length: 30
    The source object primary key of the outbound message.
  • Title: Source Object Template Name
    Maximum Length: 240
    The template name of the outbound message.
  • Title: Source Object Type Code
    Maximum Length: 30
    The source object type code of the outbound message.
  • Title: Status Code
    Maximum Length: 30
    The status code of the outbound message.
  • Title: Status Details
    Maximum Length: 1000
    The status details of the outbound message.
  • Title: Stripe Code
    Maximum Length: 30
    The stripe code of the outbound message.
  • Title: Subject
    Maximum Length: 400
    The subject of the outbound message.
  • Title: Can Update Message
    Indicates whether the outbound message has been updated.
  • Title: Use Posted by Party Email
    Maximum Length: 1
    Default Value: false
    The email of the user who posted the outbound message.
  • Title: Use Posted by Party Name
    Maximum Length: 1
    Default Value: false
    The name of the user who posted the outbound message.
Nested Schema : Outbound Message Parts
Type: array
Title: Outbound Message Parts
The outbound message parts resource is used to view, create, update, and delete an outbound message part. It's used to get the description of the root outbound message resource part.
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Corporate Currency Code
    Maximum Length: 15
    The corporate currency code associated with the message part. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Type of Currency Conversion Rate
    Maximum Length: 30
    The currency conversion rate type for the message part. A list of valid values are defined in the lookup ZCA_COMMON_RATE_TYPE. Review and update the profile option using the Setup and Maintenance work area, Manage Currency Profile Options task.
  • Title: Currency Code
    Maximum Length: 15
    The currency code associated with the message part. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Outbound Message ID
    The unique identifier of the outbound message detail.
  • Title: Outbound Message Part ID
    The unique part identifier of the outbound message detail.
  • Title: Part Name
    Maximum Length: 64
    The part name of the outbound message detail.
  • Title: Part Type Code
    Maximum Length: 30
    The part type of the outbound message details.
  • Title: Part Value
    Maximum Length: 2000
    The part value of the outbound message details.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : outboundMessages-item-response
Type: object
Show Source
  • Title: Alternate Message ID
    Maximum Length: 2000
    The unique identifier of the outbound email in the email delivery application.
  • Title: Body
    The body of the outbound message.
  • Title: Business Organization ID
    The unique identifier of the business unit organization Id.
  • Title: Channel ID
    The unique identifier of the channel of the outbound Message.
  • Title: Channel Type Code
    Maximum Length: 30
    The channel type code.
  • Title: Corporate Currency Code
    Maximum Length: 15
    The corporate currency code associated with the outbound message. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the code.
  • Title: Creation Date
    Read Only: true
    The date when the record was created.
  • Title: Type of Currency Conversion Rate
    Maximum Length: 30
    The currency conversion rate type associated with the outbound message. A list of valid values are defined in the lookup ZCA_COMMON_RATE_TYPE. Review and update the profile option using the Setup and Maintenance work area, Manage Currency Profile Options task.
  • Title: Currency Code
    Maximum Length: 15
    The currency code associated with the outbound message. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Can Delete Message
    Read Only: true
    Indicates whether the outbound message record can be deleted.
  • Title: Delivery Type Code
    Maximum Length: 30
    Default Value: ORA_SVC_IMMEDIATE
    The delivery type code of the outbound message.
  • Title: Last Updated Date
    Read Only: true
    The date when the outbound message was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the outbound message.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the outbound message.
  • Links
  • Title: Message Content
    The content of the outbound message, such as the contents of an email.
  • Title: Outbound Message ID
    The unique identifier of the outbound message.
  • Title: Outbound Message Number
    Maximum Length: 30
    The alternate key identifier of the outbound message.
  • Outbound Message Parts
    Title: Outbound Message Parts
    The outbound message parts resource is used to view, create, update, and delete an outbound message part. It's used to get the description of the root outbound message resource part.
  • Title: Posted by Party ID
    The unique party identifier of the user who posted the outbound message.
  • Title: Processing Status Code
    Maximum Length: 30
    The processing status code of the outbound message.
  • Title: Reply to Address
    Maximum Length: 240
    The reply to address of the outbound message.
  • Title: Retry Count
    Default Value: 0
    The retry count of the outbound message.
  • Title: Sender Email Source Code
    Maximum Length: 30
    The source code of the sender email for the outbound message.
  • Title: Sender Name
    Maximum Length: 100
    The name of the sender who sent the outbound message.
  • Title: Sent Date
    The date when the message was sent by the sender.
  • Title: Source Code
    Maximum Length: 30
    The source code of the outbound message.
  • Title: Source Message Object ID
    The object identifier of the outbound message.
  • Title: Source Message Object Type Code
    Maximum Length: 30
    The source message object type code of the outbound message.
  • Title: Source Object ID
    The source object identifier of the outbound message.
  • Title: Source Object Primary Key Name
    Maximum Length: 30
    The source object primary key of the outbound message.
  • Title: Source Object Template Name
    Maximum Length: 240
    The template name of the outbound message.
  • Title: Source Object Type Code
    Maximum Length: 30
    The source object type code of the outbound message.
  • Title: Status Code
    Maximum Length: 30
    The status code of the outbound message.
  • Title: Status Details
    Maximum Length: 1000
    The status details of the outbound message.
  • Title: Stripe Code
    Maximum Length: 30
    The stripe code of the outbound message.
  • Title: Subject
    Maximum Length: 400
    The subject of the outbound message.
  • Title: Can Update Message
    Indicates whether the outbound message has been updated.
  • Title: Use Posted by Party Email
    Maximum Length: 1
    Default Value: false
    The email of the user who posted the outbound message.
  • Title: Use Posted by Party Name
    Maximum Length: 1
    Default Value: false
    The name of the user who posted the outbound message.
Nested Schema : Outbound Message Parts
Type: array
Title: Outbound Message Parts
The outbound message parts resource is used to view, create, update, and delete an outbound message part. It's used to get the description of the root outbound message resource part.
Show Source
Nested Schema : outboundMessages-OutboundMsgParts-item-response
Type: object
Show Source
  • Title: Corporate Currency Code
    Maximum Length: 15
    The corporate currency code associated with the message part. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the outbound message recipient.
  • Title: Creation Date
    Read Only: true
    The date when the outbound message was created.
  • Title: Type of Currency Conversion Rate
    Maximum Length: 30
    The currency conversion rate type for the message part. A list of valid values are defined in the lookup ZCA_COMMON_RATE_TYPE. Review and update the profile option using the Setup and Maintenance work area, Manage Currency Profile Options task.
  • Title: Currency Code
    Maximum Length: 15
    The currency code associated with the message part. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Can Delete Message Part
    Read Only: true
    Indicates whether the outbound message is deleted.
  • Title: Last Updated Date
    Read Only: true
    The date when the outbound message detail was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The login of the user who last updated the outbound message detail.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the outbound message detail.
  • Links
  • Title: Outbound Message ID
    The unique identifier of the outbound message detail.
  • Title: Outbound Message Part ID
    The unique part identifier of the outbound message detail.
  • Title: Part Name
    Maximum Length: 64
    The part name of the outbound message detail.
  • Title: Part Type Code
    Maximum Length: 30
    The part type of the outbound message details.
  • Title: Part Value
    Maximum Length: 2000
    The part value of the outbound message details.
  • Title: Can Update Message Part
    Read Only: true
    Indicates whether the outbound message can be updated.
Back to Top

Examples

The following example shows how to create an outbound message by submitting a POST request on the REST resource using cURL.

cURL Command

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/outboundMessages

Example of Request Body

The following example shows the contents of the request body in JSON format.

{
  "SourceObjId": 300100187585268,
  "SourceObjTypeCd": "ServiceRequest",	
  "Subject": "Outbound Test with default channel- Rakesh 1",
  "Body": "aHR0cHM6Ly93d3cuZ29vZ2xlLmNvLmluL21hcHMvZGlyL0RMRitDeWJlcitHcmVlbnMsK0RMRitDeWJlcitDaXR5LCtETEYrUGhhc2UrMiwrU2VjdG9yKzI0LCtHdXJ1Z3JhbSwrSGFyeWFuYS8vQDI4LjQ5MzY4NjgsNzcuMDIyODkxOSwxMnovZGF0YT0hNG04ITRtNyExbTUhMW0xITFzMHgzOTBkMTkzNzBhMGQ4NjIzOjB4YWE5NzI1MWUwNWM2Y2Q2YiEybTIhMWQ3Ny4wOTI5MzMhMmQyOC40OTM3MDQ3ITFtMA==",
  "SourceCd": "ORA_SVC_API",
  "StatusCd" : "ORA_SVC_COMMITTED",
  "ProcessingStatusCd" : "ORA_SVC_READY",
  "ReplyToAddress" : "fuscdrmsmc17_extservice@adcdat05.us.oracle.com",
  "StripeCd": "ORA_SVC_CRM",
  "RetryCount": 0,
  "SenderName": "Sales Admin",
  "OutboundMsgParts": [
    {
      "PartTypeCd": "ORA_SVC_TO",
      "PartName": "To",
      "PartValue": "rakesh.ambat@adcdat05.us.oracle.com"
    }
  ]
}

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
  "OutboundMessageId": 300100194002148,
  "SourceMsgObjId": null,
  "SourceObjId": 300100187585268,
  "SourceObjTypeCd": "ServiceRequest",
  "SourceObjTemplateName": null,
  "SourceObjPkName": null,
  "PostedByPartyid": null,
  "Subject": "Outbound Test with default channel- Rakesh 1",
  "SourceCd": "ORA_SVC_API",
  "ChannelId": null,
  "StatusCd": "ORA_SVC_COMMITTED",
  "StatusDetails": null,
  "ProcessingStatusCd": "ORA_SVC_READY",
  "SentDate": null,
  "ReplyToAddress": "fuscdrmsmc17_extservice@adcdat05.us.oracle.com",
  "BUOrgId": null,
  "StripeCd": "ORA_SVC_CRM",
  "CreationDate": "2020-08-05T11:35:32.051+00:00",
  "CreatedBy": "SALES_ADMIN",
  "LastUpdateDate": "2020-08-05T11:35:32.051+00:00",
  "LastUpdatedBy": "SALES_ADMIN",
  "LastUpdateLogin": "ABC957D47349945CE053773AF80A0B8D",
  "ChannelTypeCd": null,
  "RetryCount": 0,
  "SourceMsgObjTypeCd": null,
  "OutboundMessageNumber": "CDRM_0000049009",
  "SenderName": "Sales Admin",
  "UsePostedByEmailFlag": false,
  "UsePostedByNameFlag": false,
  "UpdateFlag": true,
  "DeleteFlag": true,
  "CorpCurrencyCode": null,
  "CurcyConvRateType": null,
  "CurrencyCode": null,
  "OutboundMsgParts": [
    {
      "OutboundMsgPartId": 300100194002149,
      "OutboundMessageId": 300100194002148,
      "PartTypeCd": "ORA_SVC_TO",
      "PartName": "To",
      "PartValue": "rakesh.ambat@adcdat05.us.oracle.com",
      "CreationDate": "2020-08-05T11:35:32.312+00:00",
      "CreatedBy": "SALES_ADMIN",
      "LastUpdateDate": "2020-08-05T11:35:32.312+00:00",
      "LastUpdatedBy": "SALES_ADMIN",
      "LastUpdateLogin": "ABC957D47349945CE053773AF80A0B8D",
      "DeleteFlag": true,
      "UpdateFlag": true,
      "CorpCurrencyCode": null,
      "CurcyConvRateType": null,
      "CurrencyCode": null,
     ...
}

Example to compose an SR Message with batch status

The following example shows the contents of the request body to compose an SR Message with Batch status in JSON format.

Note:

You will need to create an SR before creating an SR message

URL: https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/serviceRequests/{{loc_srnumber}}/child/messagess

{
"MessageTypeCd": "ORA_SVC_RESPONSE",
"ChannelTypeCd": "ORA_SVC_EMAIL",
"RichTextFlag": true,
"SourceCd": "ORA_SVC_AGENT_UI",
"StatusCd": "ORA_SVC_COMMITTED",
"ProcessingStatusCd": "ORA_SVC_BATCH_READY",
"MessageContent": "{{ MessageContent }}",
"Subject": "{{ Subject }}",
"channelCommunication": [
{
"ChannelId": "ChannelId",
"PartyViaEndPoint": "john.doe@oracle.com",
"RoutingCd": "ORA_SVC_TO"
}
]
}

Example to compose an Outbound Message with Batch status

The following example shows the contents of the request body in JSON format.

URL: https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/outboundMessages

{
    "Subject": "{{ MessageTitle }}",
    "SourceCd": "ORA_SVC_API",
    "StatusCd": "ORA_SVC_COMMITTED",
    "ProcessingStatusCd": "ORA_SVC_READY",
    "StripeCd": "ORA_SVC_CRM",
    "ChannelTypeCd": "ORA_SVC_EMAIL",
    "SenderName": null,
    "UsePostedByEmailFlag": false,
    "UsePostedByNameFlag": false,
    "Body": "{{ MessageContent }}",
    "DeliveryTypeCd": "ORA_SVC_BATCH",
    "OutboundMsgParts": [
        {
            "PartTypeCd": "ORA_SVC_TO",
            "PartName": null,
            "PartValue": "john.doe@oracle.com"
        }
    ]
}
Back to Top