Queue LinkedIn connection requests

Queue the campaign's first LinkedIn step for chosen contacts, or for the hottest eligible ones. Only contacts with recorded intent are eligible. A queue write, not a send: the launcher sends under the account's invitation ramp and behind the gate.

POSThttps://app.trygtm.com/api/v1/campaigns/{campaign}/linkedin-connections

Scope: write
MCP tool: queue_linkedin_connections

Path parameters

campaignstringrequired: Campaign name or UUID whose LinkedIn tract to start. Optional when exactly one active campaign can run LinkedIn; otherwise the error names the candidates.

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

contact_idsstring[]optional: Specific contacts instead of a heat selection, when the operator named people. Eligibility still applies; limit is ignored.
min_heatintegeroptionaldefault: 4: Minimum intent heat. 4 or more is high intent.
limitintegeroptionaldefault: 25: How many contacts to queue. Default 25.
sortstringoptionaldefault: heat: heat: hottest first. newest: most recently added first.heatnewest

Request

curl -X POST https://app.trygtm.com/api/v1/campaigns/Q4%20logistics%20leaders/linkedin-connections \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "min_heat": 4,
    "limit": 25
  }'

Response

{
  "data": {
    "summary": "Queued 18 connection requests on “Q4 logistics leaders”.",
    "queued": [
      {
        "id": "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10",
        "name": "Dana Whitfield",
        "heat": 5
      }
    ],
    "skipped": [
      {
        "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
        "name": "Lee Park",
        "reason": "Already connected on LinkedIn."
      }
    ]
  }
}