Invoice Messages

Important: this assumes invoice feature is enabled for your account.

Invoice messages are notes displayed in the activity log section of an invoice.

  1. Show all messages sent for an invoice
  2. Show a particular message
  3. Send an invoice
  4. Delete existing message
  5. Create a message for marking an invoice as sent
  6. Create a message and mark an open invoice as closed (writing an invoice off)
  7. Create a message and mark a closed (written-off) invoice as open
  8. Create a message for marking an open invoice as draft
Show all messages sent for an invoice

GET /invoices/#{invoice_id}/messages

HTTP Response: 200 Success 
<invoice-messages type="array">
  <invoice-message>
    <body>The message body goes here</body>
    <created-at type="datetime">2008-04-09T20:44:54Z</created-at>
    <id type="integer">409</id>
    <invoice-id type="integer">1420</invoice-id>
    <send-me-a-copy type="boolean">true</send-me-a-copy>
    <sent-by>My Name</sent-by>
    <sent-by-email>my@email.com</sent-by-email>
    <!-- comma separated list of recipient email addresses using the
         "Name <emai@domain.com>" format -->
    <full-recipient-list>Jane Doe &lt;jane@doe.org&gt;,
     My Name &lt;my@email.com&gt;</full-recipient-list>
    <updated-at type="datetime">2008-04-09T12:07:56Z</updated-at>
    <created-at type="datetime">2008-04-09T12:07:56Z</created-at>
  </invoice-message>
  <!-- ... -->
</invoice-messages>
Show a particular message

GET /invoices/#{invoice_id}/messages/#{message_id}

HTTP Response: 200 Success 
<invoice-message>
  <body>Anther message body goes here</body>
  <created-at type="datetime">2008-04-09T20:46:34Z</created-at>
  <id type="integer">403</id>
  <invoice-id type="integer">1420</invoice-id>
  <send-me-a-copy type="boolean">true</send-me-a-copy>
  <sent-by>My Name</sent-by>
  <sent-by-email>my@email.com</sent-by-email>
  <full-recipient-list>Jane Doe &lt;jane@doe.org&gt;,
   My Name &lt;my@email.com&gt;</full-recipient-list>
  <updated-at type="datetime">2008-04-09T12:07:56Z</updated-at>
  <created-at type="datetime">2008-04-09T12:07:56Z</created-at>
</invoice-message>
Send an invoice

POST /invoices/#{invoice_id}/messages

HTTP Response: 201 Created
Location: /invoices/#{invoice_id}/messages/#{new_id} 
<invoice-message>
  <body>Message body</body>
  <recipients>support@harvestapp.com, help@getharvest.com</recipients>
  <attach-pdf type="boolean">true</attach-pdf>
  <send-me-a-copy type="boolean">true</send-me-a-copy>
</invoice-message>
Delete existing message

DELETE /invoices/#{invoice_id}/messages/#{message_id}

HTTP Response: 200 OK.
Create a message for marking an invoice as sent

POST /invoices/#{invoice_id}/messages/mark_as_sent

HTTP Response: 200 OK. 
<invoice-message>
  <body>Optional message body goes here</body>
</invoice-message>
Create a message and mark an open invoice as closed (writing an invoice off)

POST /invoices/#{invoice_id}/messages/mark_as_closed

HTTP Response: 200 OK. 
<invoice-message>
  <body>Optional message body goes here</body>
</invoice-message>
Create a message and mark a closed (written-off) invoice as open

POST /invoices/#{invoice_id}/messages/re_open

HTTP Response: 200 OK. 
<invoice-message>
  <body>Optional message body goes here</body>
</invoice-message>
Create a message for marking an open invoice as draft

POST /invoices/#{invoice_id}/messages/mark_as_draft

HTTP Response: 200 OK.