Returns a single email. Attachments are included, but comments are kept separate at /emails/#{id}/comments.xml.
Status: 200 OK
<email>
<id type="integer">7</id>
<title>Regarding the purchase</title>
<body>It's very important</body>
<author-id type="integer">3</author-id>
<subject-id type="integer">1</subject-id>
<subject-type>#{ Party || Deal || Kase }</subject-type>
<subject-name>John Doe</subject-name>
<collection-id type="integer">1</subject-id>
<collection-type>#{ Deal || Kase }</subject-type>
<visible-to>#{Everyone || Owner || NamedGroup}</visible-to>
<owner-id type="integer">#{ user_id -- when visble-to is "Owner"}</owner-id>
<group-id type="integer">#{ group_id -- when visble-to is "NamedGroup"}</group-id>
<updated-at type="datetime">2007-02-27T18:42:28Z</updated-at>
<created-at type="datetime">2006-05-16T17:26:00Z</created-at>
<attachments>
<attachment>
<id type="integer">1</id>
<url>https://example.highrisehq.com/files/1</url>
<name>picture.png</name>
<size type="integer">72633</name>
</attachment>
<attachment>
<id type="integer">2</id>
<url>https://example.highrisehq.com/files/2</url>
<name>document.txt</name>
<size type="integer">8837</name>
</attachment>
</attachments>
</email>
Returns a collection of emails that are visible to the authenticated user and related to a specific person, company, case or deal. The list is paginated using offsets. If 25 elements are returned (the page limit), use ?n=25 to fetch the next 25 and so on.
Status: 200 OK
<emails>
<email>
...
</email>
<email>
...
</email>
</emails>
Creates a new email with the currently authenticated user as the author.
The subject of the email (who it belongs to) can either be set through the url or through the subject-type and subject-id tags. Using /companies/5/emails.xml as the target for the POST is the same as using /emails.xml with subject-type “Party” and subject-id “5”.
By default, a new email is assumed to be visible to Everyone. You can also chose to make the email only visible to the creator using “Owner” as the value for the visible-to tag. Or “NamedGroup” and pass in a group-id tag too.
Note: Adding attachments to a email is not yet supported.
<email>
<title>Regarding the purchase</title>
<body>I just wanted to talk to you about the purchase.</body>
<subject-id type="integer">4</subject-id>
<subject-type>Party</subject-type>
</email>
Status: 201 Created
Location: https://example.highrisehq.com/emails/#{new-email-id}.xml
<email>
...
</email>
Updates an existing email with new details from the submitted XML.
<email>
<body>Hello world is now part of a case!</body>
<subject-id>1</subject-id>
<subject-type>#{ Party || Deal || Kase }</subject-type>
</email>
Status: 200 OK
Destroys the email at the referenced URL.
Status: 200 OK