# API posting instructions

**URL:** <https://community.hubspot.com/t/api-posting-instructions/63783>\
**Category:** Account & Settings\
**Tags:** integrations\
**Created:** [August 25, 2022, 10:22pm UTC](https://community.hubspot.com/t/api-posting-instructions/63783 "2022-08-25T22:22:34Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![CCochran](https://avatars.discourse-cdn.com/v4/letter/c/9fc348/32.png) [@CCochran](https://community.hubspot.com/u/CCochran)\
**Post date:** [August 25, 2022, 10:22pm UTC](https://community.hubspot.com/t/api-posting-instructions/63783/1 "2022-08-25T22:22:34Z")

</div>

I am working with a company that wants to post leads to my account and are asking for API posting instructions. Any help would be appreciated

This is from the company

We are looking for API posting instructions for leads. You may be using a different term in the system such as “Contacts”. Whats important is that we receive instructions on how to post, including field name mapping, and API key and posting URL.

They want to add the following information

contact name

address

email

phone

we also can post info about the consumer (optional)

electricity bill

electricity bill amount

roof shading

we also can post other info about the publisher (optional)

publisher id

sub id

---

<div class="post-metadata">

**Author:** ![coldrickjack](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/coldrickjack/32/6684_2.png) [@coldrickjack](https://community.hubspot.com/u/coldrickjack)\
**Post date:** [August 26, 2022, 9:24am UTC](https://community.hubspot.com/t/api-posting-instructions/63783/2 "2022-08-26T09:24:07Z")

</div>

Hi @CCochran,

I’d recommend sending them the [CRM API Documentation](https://developers.hubspot.com/docs/api/crm/contacts). If you are looking to create a contact in the system you would be using the **POST** `/crm/v3/objects/contacts` endpoint. If there is a large amount of contacts you could also us the **POST** `/crm/v3/objects/contacts/batch/create` endpoint. This is generally more efficient as you can create up to 10 contacts in a single request. Within your requests body you include key value pairs to allow you to set contact properties on creation. This data is in JSON format.

You’ll also need to inform them of the methods of authorizing API requests, this is documented [here](https://developers.hubspot.com/docs/api/private-apps). Finally, I’m sure you are taken the necessary precautions but be mindful of whom you allow to integrate with your HubSpot portal.