Title: Create Connection

URL Source: https://docs.shipp.ai/api-reference/connections-create/

Markdown Content:
---
description: API Reference to Create Connection
---

[ Skip to content](#post-apiv1connectionscreate) 

* [  How to Shipp ](../../how-to/)
* [  API Reference ](../)
* [  List Connections ](../connections-list/)
* [  Run Connection ](../connections-run/)
* [  Sport Schedule ](../sport-schedule/)
* [  Run Connection Output ](../connections-run-data-shape/)
* [  Error Format ](../error-format/)
* [  Usage Tips ](../usage-tips/)
* [  Versioning ](../versioning/)
* [  x402 Payments ](../x402/)
* [  Guides ](../../platform-guides/)
* [  Go To Shipp Dashboard ](https://platform.shipp.ai)

# Create Connection

Diving Deep?

This page is designed for AI Agents & users developing code directly. See [Getting Started](../../) and [Platform Guides](../../platform-guides/)

---

## `POST /api/v1/connections/create`[¶](#post-apiv1connectionscreate "Permanent link")

Create a new **raw-data connection**.

cURLJavaScriptPython

`[](#%5F%5Fcodelineno-0-1)curl https://api.shipp.ai/api/v1/connections/create?api_key=$api_key -d '{
[](#%5F%5Fcodelineno-0-2)  "filter_instructions": "High Impact Moments from MLB",
[](#%5F%5Fcodelineno-0-3)}'
`

`` [](#%5F%5Fcodelineno-1-1)const apiKey = "YOUR_API_KEY_HERE";
[](#%5F%5Fcodelineno-1-2)const url = `https://api.shipp.ai/api/v1/connections/create?api_key=${apiKey}`;
[](#%5F%5Fcodelineno-1-3)
[](#%5F%5Fcodelineno-1-4)const response = await fetch(url, {
[](#%5F%5Fcodelineno-1-5)  method: 'POST',
[](#%5F%5Fcodelineno-1-6)  headers: {
[](#%5F%5Fcodelineno-1-7)    'Content-Type': 'application/json'
[](#%5F%5Fcodelineno-1-8)  },
[](#%5F%5Fcodelineno-1-9)  body: JSON.stringify({
[](#%5F%5Fcodelineno-1-10)    filter_instructions: "High Impact Moments from MLB",
[](#%5F%5Fcodelineno-1-11)  })
[](#%5F%5Fcodelineno-1-12)});
[](#%5F%5Fcodelineno-1-13)
[](#%5F%5Fcodelineno-1-14)const result = await response.json();
 ``

`[](#%5F%5Fcodelineno-2-1)import requests
[](#%5F%5Fcodelineno-2-2)
[](#%5F%5Fcodelineno-2-3)url = "https://api.shipp.ai/api/v1/connections/create"
[](#%5F%5Fcodelineno-2-4)api_key = "YOUR_API_KEY_HERE"
[](#%5F%5Fcodelineno-2-5)
[](#%5F%5Fcodelineno-2-6)params = {
[](#%5F%5Fcodelineno-2-7)    "api_key": api_key
[](#%5F%5Fcodelineno-2-8)}
[](#%5F%5Fcodelineno-2-9)
[](#%5F%5Fcodelineno-2-10)payload = {
[](#%5F%5Fcodelineno-2-11)    "filter_instructions": "High Impact Moments from MLB",
[](#%5F%5Fcodelineno-2-12)}
[](#%5F%5Fcodelineno-2-13)
[](#%5F%5Fcodelineno-2-14)response = requests.post(url, json=payload, params=params)
`

### Request body[¶](#request-body "Permanent link")

`[](#%5F%5Fcodelineno-3-1){
[](#%5F%5Fcodelineno-3-2)  "filter_instructions": "string (required)"
[](#%5F%5Fcodelineno-3-3)}
`

### Response (200)[¶](#response-200 "Permanent link")

`[](#%5F%5Fcodelineno-4-1){
[](#%5F%5Fcodelineno-4-2)  "connection_id": "01KFXTX1WDQ68A1GS77T1XJ5YB",
[](#%5F%5Fcodelineno-4-3)  "enabled": true,
[](#%5F%5Fcodelineno-4-4)  "name": "string",
[](#%5F%5Fcodelineno-4-5)  "description": "string"
[](#%5F%5Fcodelineno-4-6)}
`

### Errors[¶](#errors "Permanent link")

* **400**: invalid JSON, empty body, or missing `filter_instructions`
* **500**: unexpected server error

 Back to top