> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tolt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Link

> This endpoint creates a tracking link.

## Base URL `https://api.tolt.com`

<br />

### Body Parameters

<ParamField body="param*" type="string">
  The tracking parameter name (e.g., 'ref', 'via')
</ParamField>

<ParamField body="value*" type="string">
  The value of the tracking parameter
</ParamField>

<ParamField body="partner_id*" type="string">
  The ID of the partner who owns this link
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="data" type="array[Object]">
  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="id" type="string">
      Unique identifier for the link, prefixed with `lnk_`
    </ResponseField>

    <ResponseField name="param" type="string">
      Tracking parameter name
    </ResponseField>

    <ResponseField name="value" type="string">
      Tracking parameter value
    </ResponseField>

    <ResponseField name="partner_id" type="string">
      ID of the partner who owns the link
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of update
    </ResponseField>

    <ResponseField name="program_id" type="string">
      Program ID the link belongs to
    </ResponseField>

    <ResponseField name="organization_id" type="string">
      Organization ID
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST 'https://api.tolt.com/v1/links' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
      "param": "ref",
      "value": "michael_scott",
      "partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={"system"}
  {
    "success": true,
    "data": [
      {
        "id": "lnk_dK9bzRGn46BhVgNFHD6fDgXW",
        "param": "ref",
        "value": "michael_scott",
        "partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
        "created_at": "2025-01-15T14:30:00.000Z",
        "updated_at": "2025-01-15T14:30:00.000Z",
        "program_id": "prg_YRsbPDAKhWfdqJbFACheh",
        "organization_id": "org_JE3mfYNL9ci7sFaJazAv2"
      }
    ]
  }
  ```
</ResponseExample>