Create a ticket

Method Details

HTTP Methods:

POST

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Headers

Products:

Service Hub

Required Scope:

Create a new ticket.

The request body should be a list of ticket properties you want to set for the new ticket, with each entry being the internal name of the property to be set, and the value of that property. You must set the ticket pipeline and stage when creating a new ticket. Please see the example for more details.

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.
Pipeline	"hs_pipeline" Used in the request JSON	The ID of the pipeline the ticket is in.
Stage	"hs_pipeline_stage" Used in the request JSON	The ticket's stage in its pipeline.

Optional Parameters	How to use	Description
Any other ticket properties	Used in the request JSON	You can include any other ticket properties in the request.

JSON

Example POST URL: https://api.hubapi.com/crm-objects/v1/objects/tickets Example POST JSON: [ { "name": "subject", "value": "This is an example ticket" }, { "name": "content", "value": "Here are the details of the ticket." }, { "name": "hs_pipeline", "value": "0" }, { "name": "hs_pipeline_stage", "value": "1" } ] Example Response: { "objectType": "TICKET", "portalId": 62515, "objectId": 177769, "properties": { "hs_lastmodifieddate": { "versions": [ { "name": "hs_lastmodifieddate", "value": "0", "timestamp": 0, "source": "CALCULATED", "sourceVid": [] } ], "value": "0", "timestamp": 0, "source": "CALCULATED", "sourceId": null }, "subject": { "versions": [ { "name": "subject", "value": "This is an example ticket", "timestamp": 1522862571921, "source": "API", "sourceVid": [] } ], "value": "This is an example ticket", "timestamp": 1522862571921, "source": "API", "sourceId": null }, "hs_pipeline": { "versions": [ { "name": "hs_pipeline", "value": "0", "timestamp": 1522862571921, "source": "API", "sourceVid": [] } ], "value": "0", "timestamp": 1535746946950, "source": "API", "sourceId": null }, "createdate": { "versions": [ { "name": "createdate", "value": "0", "timestamp": 0, "source": "API", "sourceVid": [] } ], "value": "0", "timestamp": 0, "source": "API", "sourceId": null }, "content": { "versions": [ { "name": "content", "value": "Here are the details of the ticket.", "timestamp": 1522862571921, "source": "API", "sourceVid": [] } ], "value": "Here are the details of the ticket.", "timestamp": 1522862571921, "source": "API", "sourceId": null }, "hs_pipeline_stage": { "versions": [ { "name": "hs_pipeline_stage", "value": "1", "timestamp": 1522862571921, "source": "API", "sourceVid": [] } ], "value": "1", "timestamp": 1522862571921, "source": "API", "sourceId": "" }, "time_to_close": { "versions": [ { "name": "time_to_close", "value": "", "timestamp": 1535746947086, "source": "CALCULATED", "sourceVid": [], "sourceMetadata": "" } ], "value": "", "timestamp": 1535746947086, "source": "CALCULATED", "sourceId": null } }, "isDeleted": false }