# HubSpot Integration via LowCodeAPI

## Overview

HubSpot API provides access to CRM, marketing, sales, and customer service tools. Manage contacts, deals, tickets, and automate your inbound marketing workflows.

## Base Endpoint

```
https://api.lowcodeapi.com/hubspot/
```

## Authentication

LowCodeAPI handles authentication automatically using OAuth2.0 credentials.

**Auth Type**: OAuth2.0

## Common Endpoints

### Category: Contacts

#### List Contacts

**Method**: `GET` | **LowCodeAPI Path**: `/crm/v3/objects/contacts`

**Full URL**:
```
https://api.lowcodeapi.com/hubspot/crm/v3/objects/contacts?api_token={api_token}
```

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | number | No | Number of results to return |
| `after` | string | No | Pagination cursor |
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/hubspot/crm/v3/objects/contacts?limit=20&api_token=YOUR_API_TOKEN"
```

---

#### Create Contact

**Method**: `POST` | **LowCodeAPI Path**: `/crm/v3/objects/contacts`

**Full URL**:
```
https://api.lowcodeapi.com/hubspot/crm/v3/objects/contacts?api_token={api_token}
```

**Description**: Create a new contact

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `properties` | object | Yes | Contact properties |
| `properties.email` | string | Yes | Contact email |
| `properties.firstname` | string | No | First name |
| `properties.lastname` | string | No | Last name |

**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/hubspot/crm/v3/objects/contacts?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "properties": {
      "email": "[email protected]",
      "firstname": "John",
      "lastname": "Doe"
    }
  }'
```

---

## Usage Examples

### Example 1: Contact Management

```bash
# Step 1: List contacts
# No ID required - lists all contacts
curl -X GET "https://api.lowcodeapi.com/hubspot/crm/v3/objects/contacts?limit=20&api_token=YOUR_API_TOKEN"

# Step 2: Create a new contact
# No ID required - creates contact and returns contact ID
curl -X POST "https://api.lowcodeapi.com/hubspot/crm/v3/objects/contacts?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "properties": {
      "email": "[email protected]",
      "firstname": "Jane",
      "lastname": "Smith"
    }
  }'

# Step 3: Get specific contact
# Replace CONTACT_ID with ID from previous step
curl -X GET "https://api.lowcodeapi.com/hubspot/crm/v3/objects/contacts/contactId?contactId=CONTACT_ID&api_token=YOUR_API_TOKEN"
```

## Complete Endpoint Reference

- **Official Documentation**: [https://developers.hubspot.com/docs/api/crm](https://developers.hubspot.com/docs/api/crm)