DDEX ERN 4.1.1 catalogue delivery via authenticated HTTPS webhook and SFTP
FlipDistro supports DDEX ERN 4.1.1 catalogue delivery through an authenticated HTTPS webhook and SFTP-based delivery infrastructure. Delivery packages include the DDEX ERN XML, master audio, artwork, manifest, and SHA-256 checksums. Packages are validated prior to delivery and delivery status is tracked within the FlipDistro platform.
Integration Capability
FlipDistro delivers catalogue packages using DDEX ERN 4.1.1 over an authenticated HTTPS webhook, with SFTP-based delivery for large file transfers. Each delivery package contains the ERN XML, master audio, artwork, a JSON manifest, and SHA-256 checksums — all validated before delivery is attempted. Below are the delivery methods currently in production.
FlipDistro generates and delivers Electronic Release Notification messages conforming to DDEX ERN 4.1.1. Delivery packages include the ERN XML, master audio, artwork, manifest, and SHA-256 checksums — all validated prior to delivery.
Delivery packages are pushed to your endpoint via an authenticated HTTPS webhook. Each push is signed with a shared secret header for verification, and delivery status is tracked within the FlipDistro platform.
For large file transfers and back-catalogue migrations, FlipDistro delivers structured packages to your SFTP server using SFTP, with your folder naming conventions and manifest format.
API Integration
Delivery packages are pushed to your endpoint via an authenticated HTTPS webhook. FlipDistro assembles the package (ERN XML, audio, artwork, manifest, checksums), validates all assets, and pushes the complete package as a base64-encoded JSON payload with a shared-secret authentication header. Below are the delivery operations and status callbacks supported.
POST /webhookPush a complete delivery package (ERN XML + audio + artwork + manifest + checksums) as a base64-encoded JSON payload.x-webhook-secretShared-secret authentication header included on every webhook push for request verification.POST /sftpSFTP delivery of structured package files to partner-configured host, port, and directory.GET /batches/{id}/statusRetrieve delivery batch status: pending, assembling, ready, delivered, or failed.POST /batches/{id}/retryRetry a failed delivery batch — re-assembles and re-pushes the package.GET /batchesList delivery batches with status filtering and pagination.POST /ackPartner callback endpoint for ERN acknowledgement and validation feedback.POST /status-callbackPartner async callback to report delivery confirmation or errors after ingestion.Every webhook push includes an x-webhook-secret header with a shared secret for request verification. All communication is over TLS-encrypted HTTPS. Delivery status is tracked within the FlipDistro platform through the full lifecycle: pending → assembling → ready → delivered (or failed), with error messages logged for any failed delivery.
DDEX Compatibility
FlipDistro generates DDEX ERN 4.1.1 messages with the CommonReleaseTypes/14/Audio release profile. Each package includes the full ERN XML (MessageHeader, ResourceList with SoundRecordings and Images, ReleaseList, and DealList), along with the actual master audio and artwork binaries. WAV durations are parsed from file headers and included as Duration elements in the ERN. SHA-256 checksums are computed for every asset and included in checksums.json for integrity verification on receipt.
Metadata
FlipDistro captures comprehensive metadata for each release. Our schema maps cleanly to DDEX DSR (Digital Release/Recording) message fields and can be adapted to your platform\'s JSON schema for API-based delivery. Whatever fields your pipeline requires, we can populate and deliver them.
Assets
Workflow
FlipDistro compiles release and track metadata (title, ISRC, UPC, artist, genre, territory rights, deal terms) from the catalogue into the DDEX ERN 4.1.1 schema.
Master audio (WAV) and artwork are downloaded from FlipDistro storage. WAV duration is parsed from binary headers. SHA-256 checksums are computed from actual file content.
The DDEX ERN 4.1.1 XML is generated with MessageHeader, ResourceList (SoundRecordings + Images), ReleaseList, and DealList. A JSON manifest and checksums.json are assembled alongside.
All files (ERN XML, audio, artwork, manifest, checksums) are bundled into a single delivery package. The package is validated — all assets present, checksums verified — before delivery is attempted.
The complete package is pushed to the partner endpoint via an authenticated HTTPS webhook (with x-webhook-secret header) or delivered via SFTP. Delivery status transitions to "delivered" on success.
Delivery status is tracked within FlipDistro (pending → assembling → ready → delivered / failed). Partner ack callbacks confirm ingestion. Failed batches are retained with error logs for retry.
Onboarding
Integrating with a new partner is straightforward — provide a webhook URL and shared secret, or SFTP credentials, and FlipDistro handles the rest. The process below outlines how we go from credential exchange to live catalogue delivery.
Contact our partnerships team to set up DDEX ERN 4.1.1 delivery to your platform via HTTPS webhook or SFTP.