> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifygtm.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Send records via API
> Send data from external tools and systems via API.
export const ClayLogo = ({size = 24} = {}) =>
;
## Overview
For tools and data sources that can't be connected using an existing
integration, Unify's [Data API](/developers/api/data/overview) can be used
instead. This general-purpose API allows you to programmatically find, create,
update, and delete records in Unify.
## Quickstart
Navigate to
[Settings → Developers](https://app.unifygtm.com/dashboard/settings/integrations/api-keys)
in Unify and select **Generate API Key**.
If you are writing Python or TypeScript code, you can install the official
Unify SDK to simplify interacting with the API.
Install and use the official Unify Python library.
Install and use the official Unify TypeScript library.
You can create records for any object in Unify, including standard objects
like `company` or `person`. But you can also create custom objects with
whatever attributes and relationships you need.
Create and manage objects, attributes, and records in Unify via API.
Create and manage objects, attributes, and records within the Unify app.
Now you can push records into the selected object.
The recommended API for creating and updating records is [Upsert record](/developers/api/data/records/upsert).
This allows you to specify a unique attribute to match existing records and
create or update based on whether a match is found, preventing duplicates.
```python Python theme={null}
record = client.data.records.upsert(
object_name="my_object",
match={
"email": "jane@example.com",
},
create_or_update_if_empty={
"email": "jane@example.com",
"login_count": 12,
"plan_tier": "pro",
},
)
print(f"Record ID: {record.data.id}")
print(f"Email: {record.data.attributes['email']}")
```
```typescript TypeScript theme={null}
const record = await client.data.records.upsert('my_object', {
match: {
email: 'jane@example.com',
},
create_or_update_if_empty: {
email: 'jane@example.com',
login_count: 12,
plan_tier: 'pro',
},
});
console.log(`Record ID: ${record.data.id}`);
console.log(`Email: ${record.data.attributes.email}`);
```
```shell curl theme={null}
curl -X POST 'https://api.unifygtm.com/data/v1/objects/product_user/records/upsert' \
-H 'X-Api-Key: ${UNIFY_API_KEY}' \
-H 'Content-Type: application/json' \
-d '{
"match": {
"email": "jane@example.com"
},
"create_or_update_if_empty": {
"email": "jane@example.com",
"login_count": 12,
"plan_tier": "pro"
}
}'
```
The record should now exist in Unify. You can verify this by searching for
the record in the UI or by retrieving it via API.
```python Python theme={null}
record = client.data.records.find_unique(
object_name="my_object",
match={
"email": "jane@example.com",
},
)
print(f"Record ID: {record.data.id}")
print(f"Email: {record.data.attributes['email']}")
```
```typescript TypeScript theme={null}
const record = await client.data.records.findUnique('my_object', {
match: {
email: 'jane@example.com',
},
});
console.log(`Record ID: ${record.data.id}`);
console.log(`Email: ${record.data.attributes.email}`);
```
```shell curl theme={null}
curl -X POST 'https://api.unifygtm.com/data/v1/objects/product_user/records/find-unique' \
-H 'X-Api-Key: ${UNIFY_API_KEY}' \
-H 'Content-Type: application/json' \
-d '{
"match": {
"email": "jane@example.com"
}
}'
```
## What's next
Sync data from a CSV file or spreadsheet into Unify.
} horizontal>
Send records from a Clay sheet into Unify via webhook.
Explore the full Data API reference.