> For the complete documentation index, see [llms.txt](https://docs.atomyx.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.atomyx.io/atomyx-submit/implementation/api-integration/submit-api-overview.md). # Submit API Overview The Atomyx Submit API allows external systems to create Submit jobs programmatically. Use the API when another platform needs to send job information, artwork, order metadata, or customer-facing upload instructions into Atomyx Submit. Typical integration examples include: * e-commerce checkout workflows * print storefronts * MIS or ERP systems * workflow automation platforms * customer upload portals * automated artwork submission flows The Submit API currently focuses on job creation. When a job is created, Atomyx Submit returns an upload URL that can be shared with the end user so they can upload, check, review, approve, or reject artwork depending on the enabled capabilities. The API can also be used to pre-supply artwork by providing a publicly accessible artwork URL when creating the job. ### Main API action The primary API action is: ```http POST /jobs ``` This creates a new Submit job with an initial status of `created`. ### What the API returns A successful job creation response includes the Atomyx Submit job ID, current status, external ID, upload URL, metadata, enabled capabilities, branding configuration, and artwork information where applicable. ### Status updates Submit can send status updates to an external system by using a configured callback URL. Callbacks are sent as HTTP `POST` requests with JSON payloads and are authenticated using HMAC signatures. See **Callbacks and Status Updates** for more detail. ### Source of truth The full technical reference is available in the API Reference page. The OpenAPI source is: ``` https://submit.atomyx.io/api/openapi.json ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.atomyx.io/atomyx-submit/implementation/api-integration/submit-api-overview.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.