There's a new version of the HubSpot API
We're also working on a new documentation website, you're invited to check it out and give us your feedback.
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
CRM
crm.schemas.deals.write
Create a property on every deal object to store a specific piece of data. In the example below, we want to store an invoice number on a separate field on deals.
| Required Parameters | How to use | Description |
|---|---|---|
| OAuth access token or private app access token | Authorization: Bearer {token} header | Used to authenticate the request. Please see this page for more details about authentication. |
| Property JSON | Used in the request body (see below) | This is JSON that represents a new property that you're creating. This should be in JSON format - seen below in the code sample given. Also note that there are a set number of field types that you can create. These pertain to the form fields that you use in your forms to convert new contacts. Field types are as follows:
Also, there are certain 'types' of data that you can have populate each of these fields - these are as follows:
|
| Optional Parameters | How to use | Description |
|---|---|---|
| None | None | No optional parameters for this method. |
Example URL to POST to: https://api.hubapi.com/properties/v1/deals/properties
Note: Your "Content-Type" must be application/json.
Note This replaces the deprecated URL POST /deals/v1/properties/
