{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"4bc50897-5c4e-4b26-af55-6681036a6b69","name":"Upsales API","description":"Welcome to the Upsales API! You can use this API to access all our API endpoints, such as the CRM API to look up sales data, or the Marketing Automation API to create leads into Upsales.\n\nThe API is organized around REST. All requests should be made over SSL. All request and response bodies, including errors, are encoded in JSON.\n\n## Please optimise your apps API request usage\n\nUpsales supplies a free API service for up to 99 999 API calls per day. A custom using more than this daily will be subject to a tier-based fee. (More usage equals higher cost).\n\nAs an app developer, we ask you to please optimise your API traffic in order for your customers to not perceive your service as a larger expense than it has to be.\n\n## Authentication\n\nAuthenticate your account by including your secret key in API requests. You can manage your API keys in under settings in Upsales as a admin users. Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such GitHub, client-side code, and so forth.\n\n## Format\n\nAlways include content-type: application/json as a header\n\n## Errors\n\nOur API returns standard HTTP success or error status codes. For errors, we will also include extra information about what went wrong encoded in the response as JSON.\n\n| Http Code | Description |\n| --- | --- |\n| 200 - OK | Everything worked as expected |\n| 400 - Bad Request | The request was unacceptable, often due to missing a required parameter. |\n| 401 - Unauthorized | No valid API key provided. |\n| 404 - Not Found | The requested resource doesn't exist or you don't have access to the resource |\n| 429 - To Many Requests | Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |\n\n## Pagination\n\nOur list endpoints implements pagination. The limit of entries is set using the `limit` parameter in the query-string. The default limit is set to 1000 and the maximum limit is 2000. To retreieve the next page you use the `offset`\\-parameter in the query-string. It's value is the number of entries that you want to skip.\n\nTo be 100% sure you get all entities you need sort on ID when you do the pagination. For example if you want to fetch all companies, [https://integration.upsales.com/api/v2/accounts?sort=id&limit=1000&id=gt:LAST_ID_OF_PREV_BATCH](https://integration.upsales.com/api/v2/accounts?sort=id&limit=1000&id=gt:LAST_ID_OF_PREV_BATCH)\n\n## Filtering\n\nWe allow for filtering on most fields on our entities. The filter format is the following\n\n- For standard attributes: `attribute=comparisontype:value`\n    \n- For custom fields: `custom=comparisontype:fieldId:value`\n    \n- If you don't provide a comparisontype then it defaults to equals `attribute=value`\n    \n- Multiple values: `attribute=comparisontype:1,2,3,4,7`\n    \n\nYou can search on related entities when using filters. Example find all contacts with value true in custom field with id 4 on the company; example: .../contacts?client.custom=eq:4:1\n\n### Comparison Types\n\n| Type | Name | Description |\n| --- | --- | --- |\n| `eq` | Equals | Exact matches |\n| `ne` | Not equals | Exact non-matches |\n| `gt` | Greater than | Value greater than |\n| `gte` | Greater than equals | Value greater than/or equals |\n| `lt` | Less than | Value less than |\n| `lte` | Less than equals | Value less than/or equals |\n\n### Examples\n\nGet account where user.id not equals 1  \n[https://integration.upsales.com/api/v2/accounts?user.id=ne:1](https://integration.upsales.com/api/v2/accounts?user.id=ne:1)\n\nGet orders where order value is greater than 100 000 and date is greater than or equals 2016-01-01  \n[https://integration.upsales.com/api/v2/order?value=gt:100000&date=gte:2016-01-01](https://integration.upsales.com/api/v2/order?value=gt:100000&date=gte:2016-01-01)\n\nGet contacts where customfield with id 1 is greater than 2016-03-05  \n[https://integration.upsales.com/api/v2/contacts?custom=gte:1:2016-01-01](https://integration.upsales.com/api/v2/contacts?custom=gte:1:2016-01-01)\n\n# Rate Limits\n\nAt Upsales we apply rate limits in order to protect our systems from abuse and over-utilization of our server resources\n\nThe rate limit for an API key against Upsales API is 200 requests per 10 seconds. When an API key reaches the limit the caller receives a HTTP error with status 429 (Too Many Requests)\n\nThe caller will receive the remaining amount of requests available and the number of seconds until next reset in the HTTP headers\n\n`X-RateLimit-Limit` = number of requests allowed per 10 seconds\n\n`X-RateLimit-Remaining` = number of requests remaining until the next reset\n\n`X-RateLimit-Reset` = number of seconds until next rate limit reset\n\n# API Documentation Changelog\n\n2023-10-27: Added Information about rate limits\n\n# FAQ\n\n## Why do spaces disappear in string fields?\n\nUpsales trims all string fields, which means that spaces are removed at the beginning and end of a string.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"4421023","collectionId":"4bc50897-5c4e-4b26-af55-6681036a6b69","publishedId":"RW87rVf1","public":true,"publicUrl":"https://api.upsales.com","privateUrl":"https://go.postman.co/documentation/4421023-4bc50897-5c4e-4b26-af55-6681036a6b69","customColor":{"top-bar":"1D3D48","right-sidebar":"303030","highlight":"4A90E2"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2021-05-24T08:41:20.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":"https://upsales.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://api.upsales.com/view/metadata/RW87rVf1"}