# Create Suppliers

Add new suppliers to your account with company and contact information. Suppliers are used when creating purchase orders to identify where products are being ordered from.

## Create a Supplier

Use the POST method with `/v2/suppliers` to create a new supplier with company and contact information.

### Request Body Properties

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `supplier_name` | *string* | **Required** | Name of the supplier company |
| `supplier_email` | *string* (email) | Optional | Email address for sending purchase orders |
| `address_line_1` | *string* | Optional | First line of address |
| `address_line_2` | *string* | Optional | Second line of address |
| `city` | *string* | Optional | City |
| `state` | *string* | Optional | State or province code |
| `postal_code` | *string* | Optional | Postal or ZIP code |
| `country_code` | *string* | Optional | ISO 3166-1 alpha-2 country code |
| `contact_name` | *string* | Optional | Primary contact person's name |
| `contact_phone` | *string* | Optional | Contact phone number |


### Response

On success, returns an object with the newly created `supplier_id`:


```json
{
  "supplier_id": "se-567"
}
```

### Example Request & Response

**POST /v2/suppliers**

## Validation Rules

### Required Fields

- `supplier_name` uniq supplier name must be provided and cannot be empty


### Email Validation

- `supplier_email` must be a valid email format if provided
- Format: `name@domain.com`


### Country Codes

- `country_code` must be a valid ISO 3166-1 alpha-2 code
- Examples: "US", "CA", "GB", "DE", "FR", "AU"


### Phone Numbers

- No strict format required - use your preferred format
- Include country code for international numbers (+44, +1, etc.)
- Include extensions if needed (555-0100 ext 123)


## Error Handling

Common errors when creating suppliers:

**400 Bad Request**

- Missing `supplier_name`
- Invalid country code
- Email format validation failure


## Integration Workflow

### Setup New Vendor Relationship

1. **Collect Information**
  - Get official name and email from supplier
  - Request complete address for shipping origin tracking
  - Obtain primary contact details
2. **Create Supplier Record**

```http
POST /v2/suppliers
{
  "supplier_name": "New Vendor Co",
  "supplier_email": "orders@newvendor.com",
  ...
}
```
3. **Store Supplier ID**
  - Save the returned `supplier_id`
  - Use in future purchase orders
4. **Create First Purchase Order**
  - Test the supplier by creating a purchase order


## Related Resources

- [Manage Suppliers](/suppliers/overview) - Overview of supplier operations
- [Update Suppliers](/suppliers/update) - Update existing supplier information
- [Create Purchase Orders](/purchase-orders/create) - Order products from suppliers