POST
/
v1
/
quotes
/
{id}
/
send
curl --request POST \
  --url https://api.hyperline.co/v1/quotes/{id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "finance@acme.com",
  "message": "Please find attached our proposed quotation."
}'
{
  "id": "quo_hXQCd5y8P3GYXa",
  "customer_id": "cus_QalW2vTAdkR6IY",
  "invoicing_entity_id": "ive_47484fjdhy5",
  "template_id": "quot_9hNWq4c84Z146W",
  "crm_opportunity_id": "<string>",
  "number": "327",
  "comments": "Please find the contract and subscription details we discussed.",
  "terms": "By signing this quote, you accept our conditions of use for the use of our products and services.",
  "collect_payment_details": true,
  "collect_custom_property_ids": [],
  "attachments": [
    {
      "id": "quof_5GYXy8P3QCdaXh",
      "name": "General Conditions of Sale",
      "mimetype": "application/pdf"
    }
  ],
  "signed_file": {
    "id": "<string>",
    "name": "<string>",
    "mimetype": "<string>"
  },
  "url": "https://billing.hyperline.co/quote/quo_hXQCd5y8P3GYXa",
  "created_at": "2024-12-20T16:04:11Z",
  "automatically_start_subscription": true,
  "status": "draft",
  "subscription_id": "sub_B6ClkdqNqVNBgY",
  "amount": 200000,
  "expires_at": "2024-10-13T02:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Body

application/json
​
email
string
required

Email address to which the quote will be sent for signature.

​
message
string

Custom message used in the email content.

Response

200 - application/json
​
id
string
required

Quote ID.

​
customer_id
string
required

ID of the customer.

​
invoicing_entity_id
string
required

ID of the invoicing entity attached to the quote.

​
template_id
string | null
required

ID of the quote template.

​
crm_opportunity_id
string | null
required

ID of the related opportunity/deal in the connected CRM.

​
number
string
required

Quote sequential number.

​
comments
string | null
required

Custom comments displayed on the quote.

​
terms
string | null
required

Custom quotation terms.

​
collect_payment_details
boolean
required

Collect customer payment method mandate during signature flow or not.

​
collect_custom_property_ids
string[]
required

IDs of the customer custom properties required to be filled during the signature flow.

​
attachments
object[]
required

List of documents attached to the quote.

​
signed_file
object
required

Final signed quote (manually uploaded).

​
url
string | null
required

URL to access the quote publicly. Only applies to the pending_signature or signed quote.

​
created_at
string | null
required

UTC date time string in the ISO 8601 format.

​
automatically_start_subscription
boolean
required

Whether the subscription should be automatically started when the quote is signed.

​
status
enum<string>
required

Quote status.

  • draft: The quote is a draft.
  • pending_approval: The quote is pending manager review and approval.
  • changes_requested: Some changes have been requested following manager review.
  • approved: The quote is approved and ready to be sent to the customer.
  • pending_signature: The quote is awaiting the customer's signature.
  • signed: The quote is signed and fully finalized.
  • voided: The quote is voided.
Available options:
draft
​
subscription_id
string | null
required

ID of the current subscription attached to the quote. The get subscription endpoint (GET /v2/subscriptions/{id}) can be used to retrieve the related details.

​
amount
number
required

Estimated contract value.

​
expires_at
string | null
required

Quote expiration date. UTC date time string in the ISO 8601 format.

Was this page helpful?

Download quote fileSign quote