Skip to main content
GET
/
integrations
/
{integration_type}
/
{integration_name}
/
write-info
Integration Write Info
curl --request GET \
  --url https://production.trackstarhq.com/integrations/{integration_type}/{integration_name}/write-info \
  --header 'x-trackstar-api-key: <x-trackstar-api-key>'
import requests

url = "https://production.trackstarhq.com/integrations/{integration_type}/{integration_name}/write-info"

headers = {"x-trackstar-api-key": "<x-trackstar-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'x-trackstar-api-key': '<x-trackstar-api-key>'}};

fetch('https://production.trackstarhq.com/integrations/{integration_type}/{integration_name}/write-info', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://production.trackstarhq.com/integrations/{integration_type}/{integration_name}/write-info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-trackstar-api-key: <x-trackstar-api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://production.trackstarhq.com/integrations/{integration_type}/{integration_name}/write-info"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("x-trackstar-api-key", "<x-trackstar-api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://production.trackstarhq.com/integrations/{integration_type}/{integration_name}/write-info")
.header("x-trackstar-api-key", "<x-trackstar-api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://production.trackstarhq.com/integrations/{integration_type}/{integration_name}/write-info")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-trackstar-api-key"] = '<x-trackstar-api-key>'

response = http.request(request)
puts response.read_body
{
  "openapi": "3.1.0",
  "paths": {
    "/wms/returns": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatewmsReturnOngoingSchema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Create WMS Return output"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CreatewmsReturnOngoingSchema": {
        "type": "object",
        "properties": {
          "return_number": {
            "type": "string",
            "description": "Return number"
          },
          "order_id": {
            "type": "string",
            "description": "The ID of the order that the return is associated with. Can be passed into the [Order](/api-reference/wms-api/orders/get-item) endpoint for more details.",
            "example": "order_id"
          },
          "warehouse_id": {
            "type": "string",
            "description": "The ID of the warehouse receiving the return. Can be passed into the [Warehouse](/api-reference/wms-api/warehouses/get-item) endpoint for more details.",
            "example": "warehouse"
          },
          "line_items": {
            "type": "array",
            "description": "A list of inventory items included in the return.",
            "example": [
              {
                "sku": "TEST-SKU",
                "expected_quantity": 1,
                "return_cause": null
              }
            ],
            "items": {
              "$ref": "#/components/schemas/WmsReturnWriteLineItemongoing"
            }
          },
          "tracking_number": {
            "type": "string",
            "description": ""
          },
          "tracking_url": {
            "type": "string",
            "description": ""
          },
          "trackstar_tags": {
            "type": [
              "array",
              "null"
            ],
            "description": "A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.",
            "example": [
              "tag1",
              "tag2",
              {
                "tag3": "value3"
              }
            ],
            "items": {}
          }
        },
        "required": [
          "line_items",
          "order_id",
          "return_number"
        ],
        "additionalProperties": false,
        "title": "CreatewmsReturnOngoingSchema"
      },
      "WmsReturnWriteLineItemongoing": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string",
            "description": ""
          },
          "expected_quantity": {
            "type": "integer",
            "description": "",
            "example": 0
          },
          "return_cause": {
            "$ref": "#/components/schemas/ReturnCause"
          }
        },
        "required": [
          "expected_quantity",
          "sku"
        ],
        "additionalProperties": false,
        "title": "WmsReturnWriteLineItemongoing"
      },
      "ReturnCause": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "1",
              "13",
              "3"
            ],
            "description": "The reason code for this return. Specific to your connection."
          },
          "return_reason": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "damaged",
              "wrong size",
              "no longer needed"
            ],
            "description": "The reason description for this return. Specific to your connection."
          }
        },
        "required": [
          "code"
        ],
        "additionalProperties": false,
        "title": "ReturnCause"
      }
    }
  }
}
{
"error": "<string>",
"id": "<string>"
}
{
"error": "<string>",
"detail": {
"<location>": {
"<field_name>": [
"<string>"
]
}
}
}

Headers

x-trackstar-api-key
string
required

Your organization-level Trackstar API key.

Example:

"<x-trackstar-api-key>"

x-trackstar-access-token
string

Optional. Pass this in to get connection-specific field information. Your user's access token for a specific integration (ShipHero, Extensiv, etc).

Example:

"<x-trackstar-access-token>"

Path Parameters

integration_type
enum<string>
required

The type of integration to filter by.

Available options:
wms,
freight,
cart,
carrier,
erp
integration_name
string
required

The name of the integration to filter by.

Response

OpenAPI 3.1.0 formatted JSON

The response is of type PassthroughSchema · object.