--- title: "Send a proposal by email" method: PATCH path: "/api/v2/proposals/{id}/send" tags: ["Proposals"] --- # Send a proposal by email `PATCH /api/v2/proposals/{id}/send` ## Request - Base URL: `https://developer.productive.io` (the document declares no server; this is the origin it was published from) - URL: `https://developer.productive.io/api/v2/proposals/{id}/send` - Auth: none declared ## Path parameters - `id` string, required ## Response `200` Single proposal - object: A single proposal record in JSON:API format. - `data` object: The JSON:API data object for the returned proposal resource. - `attributes` object: Proposal attributes. - `budget_total` BudgetTotal (unresolved $ref) - `budget_total_default` BudgetTotalDefault (unresolved $ref) - `budget_total_normalized` BudgetTotalNormalized (unresolved $ref) - `created_at` CreatedAt (unresolved $ref) - `currency` Currency (unresolved $ref) - `currency_default` CurrencyDefault (unresolved $ref) - `currency_normalized` CurrencyNormalized (unresolved $ref) - `custom_fields` CustomFields (unresolved $ref) - `date` Date (unresolved $ref) - `disclaimer` Disclaimer (unresolved $ref) - `disclaimer_enabled` DisclaimerEnabled (unresolved $ref) - `end_date` EndDate (unresolved $ref) - `exchange_date` ExchangeDate (unresolved $ref) - `exchange_rate` string: The exchange rate applied to convert amounts to the default currency. - `footer` Footer (unresolved $ref) - `footer_interpolated` FooterInterpolated (unresolved $ref) - `link_status` LinkStatus (unresolved $ref) - `name` Name (unresolved $ref) - `note` Note (unresolved $ref) - `note_interpolated` NoteInterpolated (unresolved $ref) - `public_uuid` PublicUuid (unresolved $ref) - `purchase_order_number` PurchaseOrderNumber (unresolved $ref) - `responder_email` ResponderEmail (unresolved $ref) - `responder_name` ResponderName (unresolved $ref) - `sent_at` SentAt (unresolved $ref) - `signed` Signed (unresolved $ref) - `status` Status (unresolved $ref) - `status_changed_at` StatusChangedAt (unresolved $ref) - `identity_confirmation_enabled` IdentityConfirmationEnabled (unresolved $ref) - `identity_confirmed_at` IdentityConfirmedAt (unresolved $ref) - `pdf_url` PdfUrl (unresolved $ref) - `signed_pdf_url` SignedPdfUrl (unresolved $ref) - `number` Number (unresolved $ref) - `source` Source (unresolved $ref) - `relationships` object: Proposal relationships. - `client` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `contact` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `creator` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `deal` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `deal_creator` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `document_type` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `organization` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `project` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `proposal_from` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `proposal_to` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `responsible` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `subsidiary` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `tax_rate` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `attachment` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `scenario` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `included` unknown[]: Sideloaded related resources. - unknown - `meta` Meta: Pagination and response metadata returned with every collection endpoint. - `current_page` integer: The current page number in this paginated response (1-based). - `max_page_size` integer: Maximum number of records allowed per page for this endpoint. - `organization_features` object: Feature flags and capabilities enabled for the current organization, used for UI rendering. - `page_size` integer: Number of records returned per page in this response. - `settings` object: Organization or user settings relevant to this resource's display. - `total_count` integer: Total number of records matching the current query across all pages. - `total_pages` integer: Total number of pages available for the current query and page size. ## Other responses - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `406`: Not Acceptable - `408`: Request Timeout - `422`: Unprocessable Content - `423`: Locked - `429`: Too Many Requests - `500`: Internal Server Error ## Changes - **2026-11-02** `fa3060fd0144`: 3 warning, 8 info - added the new `bad_decimal_format` enum value to the `errors/items/code` response property for the response status `422` - added the new `non_finite_number` enum value to the `errors/items/code` response property for the response status `422` - added the new `null_bytes_in_params` enum value to the `errors/items/code` response property for the response status `422` - added the non-success response with the status `401` - …7 more - **2026-10-27** `f11a8740641a`: 1 info - endpoint added - …this revision’s changelog is incomplete [Operation history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/proposals/:id/send/patch.md) --- [API](https://skmtc.dev/productive/apis/api-documentation.md) - [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/productive/apis/api-documentation/revisions/e7bdfdf6cba3?raw)