Skip to main content
POST
Create an attachment upload URL

Authorizations

Authorization
string
header
required

Sendmux API key (smx_...)

Headers

Idempotency-Key
string

Optional client-generated key to make the request idempotent for 24 hours. Replays under the same key return the cached response; a reused key with a different body returns 409 idempotency_conflict.

Maximum string length: 255

Body

application/json
filename
string
required

Filename to associate with the uploaded attachment.

Required string length: 1 - 255
Example:

"analysis.pdf"

size_bytes
integer
required

Exact byte size that will be uploaded.

Example:

20480

content_type
string

MIME type expected for the upload.

Maximum string length: 255
Example:

"application/pdf"

sha256
string

Optional SHA-256 hex digest for the upload bytes.

Pattern: ^[a-f0-9]{64}$
Example:

"0000000000000000000000000000000000000000000000000000000000000000"

Response

Attachment upload URL created

ok
enum<boolean>
required
Available options:
true
meta
object
required
data
object
required