> ## Documentation Index > Fetch the complete documentation index at: https://developers.investorlift.com/llms.txt > Use this file to discover all available pages before exploring further. # Publish a draft as a deal > Checks the draft, checks the credit balance, locks the address and creates the deal as available. ## OpenAPI ````yaml POST /sell/drafts/{draft_id}/publish openapi: 3.1.0 info: title: Investorlift Marketplace API version: '2026-09-18' summary: List, publish and trade wholesale real estate deals on Investorlift. description: >- The Marketplace API gives a seller organization and a buyer account the same actions the Investorlift application gives them. A seller creates a draft, publishes a deal, reads its leads and answers offers. A buyer searches deals, asks for an address, makes an offer and keeps a buy box. Every answer carries a request id, and every refusal carries a problem code with one recovery sentence. contact: name: Investorlift support email: support@investorlift.com servers: - url: https://api.investorlift.com/marketplace/v1 description: Production security: - oauth2: [] tags: - name: sell description: What a seller organization does with its drafts and deals. - name: buy description: What a buyer account does with deals, offers and buy boxes. - name: me description: What this token can do right now. - name: events description: >- What Investorlift sends to a webhook endpoint, one entry for each event type. paths: /sell/drafts/{draft_id}/publish: post: tags: - sell summary: Publish a draft as a deal description: >- Checks the draft, checks the credit balance, locks the address and creates the deal as available. The publish spends credits and needs the acquisition contract, as the app does. The API charges no card. operationId: publishSellDraft parameters: - name: draft_id in: path required: true description: The public id in the path, for example draft_id as mdl_a1b2c3d4e5f6. schema: type: string - name: Idempotency-Key in: header required: true description: >- A key of your own that names this attempt. The same key with the same body replays the stored answer. schema: type: string minLength: 1 maxLength: 255 requestBody: required: true content: application/json: schema: type: object properties: notify_buyers: default: true description: False publishes the deal without the alert. type: boolean disposition_manager_id: description: >- A member of the organization, as mbr_. The caller by default. type: string minLength: 1 additionalProperties: false responses: '201': description: Created headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/PublishedDeal' meta: $ref: '#/components/schemas/Meta' required: - data - meta additionalProperties: false '400': description: >- Body unusable, Identifier malformed, Parameter unusable, Parameter unknown headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.invalid_body' - $ref: '#/components/schemas/Problem.invalid_id' - $ref: '#/components/schemas/Problem.invalid_parameter' - $ref: '#/components/schemas/Problem.unknown_parameter' '401': description: Not authenticated headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.unauthorized' '402': description: Balance too low headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.insufficient_balance' '403': description: >- Designation missing, Refused, Scope missing, No organization, Not a member, Terms not accepted headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.designation_required' - $ref: '#/components/schemas/Problem.forbidden' - $ref: '#/components/schemas/Problem.insufficient_scope' - $ref: '#/components/schemas/Problem.no_organization' - $ref: '#/components/schemas/Problem.not_a_member' - $ref: '#/components/schemas/Problem.terms_required' '404': description: Not found headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.not_found' '405': description: Method not allowed headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.method_not_allowed' '409': description: >- Address taken, Deal closed, Draft under review, Key reused with a different body, Key in progress headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.address_unavailable' - $ref: '#/components/schemas/Problem.deal_closed' - $ref: '#/components/schemas/Problem.draft_under_review' - $ref: '#/components/schemas/Problem.idempotency_conflict' - $ref: '#/components/schemas/Problem.idempotency_in_progress' '422': description: Draft incomplete, Body failed validation headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.deal_incomplete' - $ref: '#/components/schemas/Problem.validation_failed' '503': description: Service unavailable headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.origin_error' security: - oauth2: - deals:write components: headers: XRequestId: description: The id this answer shares with the Investorlift request log. schema: type: string schemas: PublishedDeal: type: object properties: deal_id: type: string description: The new deal id, mdl_. fee: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: The credits the publish spent. status: type: string const: available required: - deal_id - fee - status additionalProperties: false Meta: type: object properties: request_id: type: string description: The id this answer shares with the log. api_version: type: string description: The contract version the body is rendered at. required: - request_id - api_version additionalProperties: false Problem.invalid_body: allOf: - $ref: '#/components/schemas/Problem' description: Body unusable. Send a JSON body with the content type application/json. properties: type: const: https://developers.investorlift.com/marketplace/errors#invalid_body title: const: Body unusable status: const: 400 code: const: invalid_body recovery: const: Send a JSON body with the content type application/json. Problem.invalid_id: allOf: - $ref: '#/components/schemas/Problem' description: >- Identifier malformed. Send the public id with its type prefix, for example mdl_a1b2c3d4e5f6. properties: type: const: https://developers.investorlift.com/marketplace/errors#invalid_id title: const: Identifier malformed status: const: 400 code: const: invalid_id recovery: const: >- Send the public id with its type prefix, for example mdl_a1b2c3d4e5f6. Problem.invalid_parameter: allOf: - $ref: '#/components/schemas/Problem' description: >- Parameter unusable. Correct the query parameter the detail names, then repeat the call. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#invalid_parameter title: const: Parameter unusable status: const: 400 code: const: invalid_parameter recovery: const: Correct the query parameter the detail names, then repeat the call. Problem.unknown_parameter: allOf: - $ref: '#/components/schemas/Problem' description: >- Parameter unknown. Remove the parameter the detail names, because this operation reads no such field. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#unknown_parameter title: const: Parameter unknown status: const: 400 code: const: unknown_parameter recovery: const: >- Remove the parameter the detail names, because this operation reads no such field. unknown_parameters: type: array items: type: string description: Every field of the request this operation does not read. required: - unknown_parameters Problem.unauthorized: allOf: - $ref: '#/components/schemas/Problem' description: >- Not authenticated. Send a current access token for this API, and start a new authorization when the token is expired. properties: type: const: https://developers.investorlift.com/marketplace/errors#unauthorized title: const: Not authenticated status: const: 401 code: const: unauthorized recovery: const: >- Send a current access token for this API, and start a new authorization when the token is expired. Problem.insufficient_balance: allOf: - $ref: '#/components/schemas/Problem' description: >- Balance too low. Add credits to the organization on Investorlift, then publish the draft again. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#insufficient_balance title: const: Balance too low status: const: 402 code: const: insufficient_balance recovery: const: >- Add credits to the organization on Investorlift, then publish the draft again. Problem.designation_required: allOf: - $ref: '#/components/schemas/Problem' description: >- Designation missing. Finish the onboarding of the side you call, then repeat the call. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#designation_required title: const: Designation missing status: const: 403 code: const: designation_required recovery: const: Finish the onboarding of the side you call, then repeat the call. designation: description: The designation the side of this operation needs. type: string enum: - seller - buyer Problem.forbidden: allOf: - $ref: '#/components/schemas/Problem' description: >- Refused. Ask Investorlift support why the account, the client or the organization is stopped. properties: type: const: https://developers.investorlift.com/marketplace/errors#forbidden title: const: Refused status: const: 403 code: const: forbidden recovery: const: >- Ask Investorlift support why the account, the client or the organization is stopped. Problem.insufficient_scope: allOf: - $ref: '#/components/schemas/Problem' description: >- Scope missing. Start a new authorization that asks for the scope named in the detail. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#insufficient_scope title: const: Scope missing status: const: 403 code: const: insufficient_scope recovery: const: >- Start a new authorization that asks for the scope named in the detail. scope: type: string enum: - marketplace:profile - deals:read - deals:write - offers:read - offers:write - inquiries:read - inquiries:write - leads:read - leads:write - contacts:read - reviews:read - buy_boxes:manage - webhooks:manage - events:read description: The scope this operation needs. required: - scope Problem.no_organization: allOf: - $ref: '#/components/schemas/Problem' description: >- No organization. Create an organization on Investorlift, then repeat the call. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#no_organization title: const: No organization status: const: 403 code: const: no_organization recovery: const: Create an organization on Investorlift, then repeat the call. Problem.not_a_member: allOf: - $ref: '#/components/schemas/Problem' description: >- Not a member. Name a user who is a member of the organization, then repeat the call. properties: type: const: https://developers.investorlift.com/marketplace/errors#not_a_member title: const: Not a member status: const: 403 code: const: not_a_member recovery: const: >- Name a user who is a member of the organization, then repeat the call. Problem.terms_required: allOf: - $ref: '#/components/schemas/Problem' description: >- Terms not accepted. Accept the Marketplace API Terms on the consent page, then start a new authorization. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#terms_required title: const: Terms not accepted status: const: 403 code: const: terms_required recovery: const: >- Accept the Marketplace API Terms on the consent page, then start a new authorization. agreement_id: type: string description: The version of the Marketplace API Terms to accept. required: - agreement_id Problem.not_found: allOf: - $ref: '#/components/schemas/Problem' description: >- Not found. Check the id, and check that the account you call with owns the resource. properties: type: const: https://developers.investorlift.com/marketplace/errors#not_found title: const: Not found status: const: 404 code: const: not_found recovery: const: >- Check the id, and check that the account you call with owns the resource. Problem.method_not_allowed: allOf: - $ref: '#/components/schemas/Problem' description: >- Method not allowed. Use one of the methods the documentation lists for this path. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#method_not_allowed title: const: Method not allowed status: const: 405 code: const: method_not_allowed recovery: const: Use one of the methods the documentation lists for this path. Problem.address_unavailable: allOf: - $ref: '#/components/schemas/Problem' description: >- Address taken. Wait for the other deal on this address to close, or publish a different property. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#address_unavailable title: const: Address taken status: const: 409 code: const: address_unavailable recovery: const: >- Wait for the other deal on this address to close, or publish a different property. Problem.deal_closed: allOf: - $ref: '#/components/schemas/Problem' description: >- Deal closed. Read the deal to see the current status, and act on an open deal instead. properties: type: const: https://developers.investorlift.com/marketplace/errors#deal_closed title: const: Deal closed status: const: 409 code: const: deal_closed recovery: const: >- Read the deal to see the current status, and act on an open deal instead. Problem.draft_under_review: allOf: - $ref: '#/components/schemas/Problem' description: >- Draft under review. Wait for the Deal Desk to finish its review of this draft, then repeat the call. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#draft_under_review title: const: Draft under review status: const: 409 code: const: draft_under_review recovery: const: >- Wait for the Deal Desk to finish its review of this draft, then repeat the call. Problem.idempotency_conflict: allOf: - $ref: '#/components/schemas/Problem' description: >- Key reused with a different body. Send a new Idempotency-Key for this body, because the stored key holds another one. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#idempotency_conflict title: const: Key reused with a different body status: const: 409 code: const: idempotency_conflict recovery: const: >- Send a new Idempotency-Key for this body, because the stored key holds another one. Problem.idempotency_in_progress: allOf: - $ref: '#/components/schemas/Problem' description: >- Key in progress. Wait one second, then repeat the call with the same Idempotency-Key. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#idempotency_in_progress title: const: Key in progress status: const: 409 code: const: idempotency_in_progress recovery: const: Wait one second, then repeat the call with the same Idempotency-Key. Problem.deal_incomplete: allOf: - $ref: '#/components/schemas/Problem' description: >- Draft incomplete. Add each field the detail names to the draft, then publish it again. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#deal_incomplete title: const: Draft incomplete status: const: 422 code: const: deal_incomplete recovery: const: Add each field the detail names to the draft, then publish it again. Problem.validation_failed: allOf: - $ref: '#/components/schemas/Problem' description: >- Body failed validation. Correct each field the detail names, then repeat the call. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#validation_failed title: const: Body failed validation status: const: 422 code: const: validation_failed recovery: const: Correct each field the detail names, then repeat the call. Problem.origin_error: allOf: - $ref: '#/components/schemas/Problem' description: >- Service unavailable. Repeat the call in a minute, and tell Investorlift support when the answer stays the same. properties: type: const: https://developers.investorlift.com/marketplace/errors#origin_error title: const: Service unavailable status: const: 503 code: const: origin_error recovery: const: >- Repeat the call in a minute, and tell Investorlift support when the answer stays the same. Problem: type: object description: >- One refusal, as RFC 9457 application/problem+json. The code picks the status, the title and the recovery sentence. properties: type: type: string format: uri description: The errors page anchor of the code. title: type: string description: The short title of the code. status: type: integer description: The HTTP status of this answer. code: type: string enum: - address_unavailable - agreement_required - api_offers_disabled - below_floor - cap_reached - client_limit - daily_cap_reached - deal_changed - deal_closed - deal_incomplete - designation_required - draft_under_review - duplicate_inquiry - forbidden - idempotency_conflict - idempotency_in_progress - idv_required - insufficient_balance - insufficient_role - insufficient_scope - invalid_body - invalid_id - invalid_parameter - invalid_transition - lead_locked - method_not_allowed - no_organization - not_a_member - not_found - offer_exists - offer_required - offer_superseded - organization_required - origin_error - person_exists - preview_expired - preview_mismatch - proof_of_funds_expired - proof_of_funds_missing - rate_limited - requirement_unmet - resource_exists - resource_limit - strike_exists - strike_window_closed - terms_required - unauthorized - unknown_parameter - validation_failed - webhook_limit - webhook_url_refused - wrong_side description: The problem code. Read this, never the title. detail: type: string description: What happened for this one request. recovery: type: string description: One sentence that says what to do next. request_id: type: string description: The id this answer shares with the log. required: - type - title - status - code - detail - recovery - request_id securitySchemes: oauth2: type: oauth2 description: >- Authorization code with PKCE. The person grants the scopes on the Investorlift consent page and accepts the Marketplace API Terms there. flows: authorizationCode: authorizationUrl: https://mogul.investorlift.com/api/auth/oauth2/authorize tokenUrl: https://mogul.investorlift.com/api/auth/oauth2/token refreshUrl: https://mogul.investorlift.com/api/auth/oauth2/token scopes: marketplace:profile: Read your account, your organization and your trust tier. deals:read: Read your deals as a seller, and the deals you see as a buyer. deals:write: >- Create drafts, add media and documents, publish deals and change their status. offers:read: >- Read the offers on your deals as a seller, and your own offers as a buyer. offers:write: Make, counter, accept, decline and withdraw offers. inquiries:read: >- Read the inquiries and address requests on your deals, and your own. inquiries:write: Send inquiries and address requests, and answer address requests. leads:read: Read the leads on your deals with their history. leads:write: Set a lead status, add a lead and file a strike. contacts:read: >- Read the email address and the phone number of a buyer on your deals. reviews:read: Read a seller public profile and the reviews of that seller. buy_boxes:manage: Read and change your buy boxes and their alerts. webhooks:manage: Create, read and delete the webhook endpoints of your side. events:read: Read the event feed of your side. ```` ## Related topics - [Publish a draft as a deal](/api-reference/sell/publish-a-draft-as-a-deal.md) - [Create a draft deal](/api-reference/sell/create-a-draft-deal.md) - [List the drafts of the organization](/api-reference/sell/list-the-drafts-of-the-organization.md) - [Attach a document to a draft](/api-reference/sell/attach-a-document-to-a-draft.md)