Skip to main content
POST
Post external entity events

Authorizations

X-API-KEY
string
header
required

The authorization key obtained from MarketONE.

Headers

X-B3-TraceId
string

The TraceId indicates the overall ID of the trace. Every span in a trace shares this ID. The X-B3-TraceId header is encoded as 32 or 16 lower-hex characters. For example, a 128-bit TraceId header might look like 463ac35c9f6413ad48485a3953bb6124.

X-B3-SpanId
string

The SpanId is 64-bit in length and indicates the position of the current operation in the trace tree. The value should not be interpreted; it may or may not be derived from the value of the TraceId. The X-B3-SpanId header is encoded as 16 lower-hex characters. For example, a SpanId header might look like a2fb4a1d1a96d312. Unless propagating only the Sampling State, the X-B3-SpanId header is required.

X-B3-ParentSpanId
string

The ParentSpanId is 64-bit in length and indicates the position of the parent operation in the trace tree. When the span is the root of the trace tree, there is no ParentSpanId. The X-B3-ParentSpanId header may be present on a child span and must be absent on the root span. It is encoded as 16 lower-hex characters. For example, a ParentSpanId header might look like 0020000000000001.

Body

application/json
type
enum<string>
required
Available options:
terminated,
updated,
suspended,
resumed
account
object
required

The Account represents a billing relationship with a customer. As such it can contain as much or as little information as you collect about customers (people or organizations) to which you offer billing and subscriptions. Subscriptions and Transactions must belong to an Account - as such, Accounts will be required in MarketONE for billing. An Account can have any number of children accounts and may have up to one parent account. An Account owns the “on file” payment methods to be used for billing. Payment Methods can be created at the same time as an Account being created or updated, but when updating an existing Payment Method the Payment Method Endpoint must be used.

id
string

the event id provided by application generating the event.

Maximum string length: 36
applicationName
string

the name of the application sending this event

Maximum string length: 128
Example:

"BSS"

replaces
object

Response

OK