Get All Clients

GET https://YOURACCOUNT.harvestapp.com/clients

Examples

HTTP Response: 200 OK

Example request in Postman

<?xml version="1.0" encoding="UTF-8"?>
<clients type="array">
  <client>
    <id type="integer">3398386</id>
    <name>Your Account</name>
    <active type="boolean">true</active>
    <currency>United States Dollar - USD</currency>
    <highrise-id type="integer" nil="true"/>
    <cache-version type="integer">821859237</cache-version>
    <updated-at type="dateTime">2015-04-15T16:25:50Z</updated-at>
    <created-at type="dateTime">2015-04-15T16:25:50Z</created-at>
    <currency-symbol>$</currency-symbol>
    <details>123 Main St
      Anytown, NY 12345</details>
    <default-invoice-timeframe nil="true"/>
    <last-invoice-kind nil="true"/>
  </client>
</clients>
[
  {
    "client": {
        "id": 3398386,
        "name": "Your Account",
        "active": true,
        "currency": "United States Dollar - USD",
        "highrise_id": null,
        "cache_version": 821859237,
        "updated_at": "2015-04-15T16:25:50Z",
        "created_at": "2015-04-15T16:25:50Z",
        "currency_symbol": "$",
        "details": "123 Main St\r\nAnytown, NY 12345",
        "default_invoice_timeframe": null,
        "last_invoice_kind": null
    }
  }
]

Get A Single Client

GET https://YOURACCOUNT.harvestapp.com/clients/{CLIENTID}

Examples

HTTP Response: 200 OK

Example request in Postman

<?xml version="1.0" encoding="UTF-8"?>
<client>
    <id type="integer">3398386</id>
    <name>Your Account</name>
    <active type="boolean">true</active>
    <currency>United States Dollar - USD</currency>
    <highrise-id type="integer" nil="true"/>
    <cache-version type="integer">821859237</cache-version>
    <updated-at type="dateTime">2015-04-15T16:25:50Z</updated-at>
    <created-at type="dateTime">2015-04-15T16:25:50Z</created-at>
    <currency-symbol>$</currency-symbol>
    <details>123 Main St
      Anytown, NY 12345</details>
    <default-invoice-timeframe nil="true"/>
    <last-invoice-kind nil="true"/>
</client>
{
    "client": {
        "id": 3398386,
        "name": "Your Account",
        "active": true,
        "currency": "United States Dollar - USD",
        "highrise_id": null,
        "cache_version": 821859237,
        "updated_at": "2015-04-15T16:25:50Z",
        "created_at": "2015-04-15T16:25:50Z",
        "currency_symbol": "$",
        "details": "123 Main St\r\nAnytown, NY 12345",
        "default_invoice_timeframe": null,
        "last_invoice_kind": null
    }
}

Create A New Client

POST https://YOURACCOUNT.harvestapp.com/clients

To create a new client, you’ll need to POST the following. Only Name is required.

Parameter Description
Name New client name.
Currency The currency you’d like to use for the client.
Currency-Symbol The symbol that correlates to the selected currency.
Active Determines if the client is active, or archived. Options: true, false.
Details Additional details, normally used for address information.
Highrise-ID Optional Highrise ID for our legacy integration
  • Once created successfully, we’ll return HTTP Response: 201 Created, along with Location /clients/{NEWCLIENTID}

Examples

<client>
  <name>Company LLC</name>
  <currency>United States Dollar - USD</currency>
  <currency-symbol>$</currency-symbol>
  <active type="boolean">true</active>
  <details>123 Main St.
  Third Floor
  New York, NY 10011
  USA
  212-555-1212
  212-555-1213 (fax)</details>
</client>
{
    "client": {
        "name": "Your Client",
        "active": true,
        "currency": "United States Dollar - USD",
        "currency_symbol": "$",
        "details": "123 Main St\r\nAnytown, NY 12345"
    }
}

Update A Client

PUT https://YOURACCOUNT.harvestapp.com/clients/{CLIENTID}

You may update client attributes using this call. Once updated successfully, we’ll return HTTP Response: 200 OK, along with Location /clients/{CLIENTID}

Activate Or Deactivate An Existing Client

POST https://YOURACCOUNT.harvestapp.com/clients/{CLIENTID}/toggle

You may toggle an existing client to active, or archived using this call. Once updated successfully, we’ll return HTTP Response: 200 OK, along with Location /clients/{CLIENTID}

If the client has active projects, Harvest will return HTTP Response: 400 Bad Request, with a Hint header.

Delete A Client

DELETE https://YOURACCOUNT.harvestapp.com/clients/{CLIENTID}