# How to create Contact using POST HTTP API

**URL:** <https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330>\
**Category:** APIs & Integrations\
**Tags:** webhooks\
**Created:** [September 19, 2019, 1:41pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330 "2019-09-19T13:41:52Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![AppyPlanet](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/appyplanet/32/82448_2.png) [@AppyPlanet](https://community.hubspot.com/u/AppyPlanet)\
**Post date:** [September 19, 2019, 1:41pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/1 "2019-09-19T13:41:52Z")

</div>

Dear Team,

I want to get contact created in my Hubspot account with the help of POST HTTP API. Mobile number will be pushed from a my company IVR resources.

Kindly help me with Push Report Webhook API, POST Method.

Thanks

---

<div class="post-metadata">

**Author:** ![IsaacTakushi](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/isaactakushi/32/70387_2.png) [@IsaacTakushi](https://community.hubspot.com/u/IsaacTakushi)\
**Post date:** [September 19, 2019, 8:38pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/2 "2019-09-19T20:38:45Z")

</div>

Welcome, @AppyPlanet.

It sounds like you want to use either [this endpoint](https://developers.hubspot.com/docs/methods/contacts/create_contact) or [this endpoint](https://developers.hubspot.com/docs/methods/contacts/create_or_update) from the Contacts API.

If you have any specific questions on how to use them, let me know.

---

<div class="post-metadata">

**Author:** ![AppyPlanet](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/appyplanet/32/82448_2.png) [@AppyPlanet](https://community.hubspot.com/u/AppyPlanet)\
**Post date:** [September 21, 2019, 3:38pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/3 "2019-09-21T15:38:48Z")

</div>

Dear Sir,

Thank you for your reply.

It was very helpful.

I want to pass Phone Number in API [https://api.hubapi.com/contacts/v1/contact/?hapikey=demo](https://api.hubapi.com/contacts/v1/contact/?hapikey=demo)

Please help me with the parameter to add in this API.

Thanks

---

<div class="post-metadata">

**Author:** ![IsaacTakushi](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/isaactakushi/32/70387_2.png) [@IsaacTakushi](https://community.hubspot.com/u/IsaacTakushi)\
**Post date:** [September 23, 2019, 12:47pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/4 "2019-09-23T12:47:39Z")

</div>

Hi, @AppyPlanet.

Glad I could help.  
If you wish to use the [_Create a new contact_](https://developers.hubspot.com/docs/methods/contacts/create_contact) endpoint, you can create a contact and pass a phone number to the `phone` property with a payload like this:

```auto
POST
https://api.hubapi.com/contacts/v1/contact/?hapikey=your_key

{
 "properties": [
 {
 "property": "email",
 "value": "contact_email@example.com"
 },
 {
 "property": "phone",
 "value": "555-122-2323"
 }
 ]
}

```

Please note that `email` property is required to create a contact in HubSpot.

---

<div class="post-metadata">

**Author:** ![AppyPlanet](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/appyplanet/32/82448_2.png) [@AppyPlanet](https://community.hubspot.com/u/AppyPlanet)\
**Post date:** [September 23, 2019, 3:30pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/5 "2019-09-23T15:30:14Z")

</div>

Dear @IsaacTakushi ,

Thank you for reply.

My point is, how to pass contact properties in API ?

like [https://api.hubapi.com/contacts/v1/contact/?hapikey=your\_key&phone=123&email=example@example.com](https://api.hubapi.com/contacts/v1/contact/?hapikey=your_key&phone=123&email=example@example.com)

Thanks

---

<div class="post-metadata">

**Author:** ![IsaacTakushi](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/isaactakushi/32/70387_2.png) [@IsaacTakushi](https://community.hubspot.com/u/IsaacTakushi)\
**Post date:** [September 23, 2019, 3:39pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/6 "2019-09-23T15:39:03Z")

</div>

Hi, @AppyPlanet.

If you are creating a company through [this `POST` endpoint](https://developers.hubspot.com/docs/methods/contacts/create_contact), you _cannot_ add properties as query parameters. Instead, they must be in the request’s payload, or body, in JSON format.

If you are _retrieving_ a contact’s data through [this `GET` endpoint](https://developers.hubspot.com/docs/methods/contacts/get_contact), on the other hand, you can define properties to be included in the response with query parameters. This will **not** create or update a contact.

---

<div class="post-metadata">

**Author:** ![AppyPlanet](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/appyplanet/32/82448_2.png) [@AppyPlanet](https://community.hubspot.com/u/AppyPlanet)\
**Post date:** [September 23, 2019, 3:59pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/7 "2019-09-23T15:59:29Z")

</div>

Dear @IsaacTakushi ,

Thank you for reply.

I am using IVR service.

My requirement is to create a contact using POST API.

Parameter for contact number in IVR service is “cNumber” and “phone” in Hubspot.

Parameters are not generic.

I am not able to create a new contact by integrating POST API to IVR service.

Please suggest me the resolution.

Thanks

---

<div class="post-metadata">

**Author:** ![IsaacTakushi](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/isaactakushi/32/70387_2.png) [@IsaacTakushi](https://community.hubspot.com/u/IsaacTakushi)\
**Post date:** [September 24, 2019, 7:42pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/8 "2019-09-24T19:42:01Z")

</div>

Hi, @AppyPlanet.

If you are trying to create contacts in HubSpot with information from your IVR service, you will have to have some intermediary app or middleware take email and `cNumber` values from your IVR service and then create and send requests containing `email` and `phone` properties to [this HubSpot endpoint](https://developers.hubspot.com/docs/methods/contacts/create_contact).

Can you specify where in the process you are encountering issues?

---

<div class="post-metadata">

**Author:** ![AppyPlanet](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/appyplanet/32/82448_2.png) [@AppyPlanet](https://community.hubspot.com/u/AppyPlanet)\
**Post date:** [September 25, 2019, 3:40pm UTC](https://community.hubspot.com/t/how-to-create-contact-using-post-http-api/16330/9 "2019-09-25T15:40:16Z")

</div>

Thank you @IsaacTakushi for the help.
