Skip to main content

Quickstart

Connect to TextUs with Nango and see data flow in 2 minutes.
1

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> TextUs.
2

Authorize TextUs

Go to Connections -> Add Test Connection -> Authorize, then enter your API Token. Later, you’ll let your users do the same directly from your app.
3

Call the TextUs API

Let’s make your first request to the TextUs API (list the accounts your token has access to). Replace the placeholders below with your Environment API key, integration ID, and connection ID:
Or fetch credentials with the Node SDK or API.You’re connected! Check the Logs tab in Nango to inspect requests.
4

Implement Nango in your app

Follow our quickstart to integrate Nango in your app.To obtain your own credentials, follow the setup guide linked below.

TextUs integration guides

Nango-maintained guides for common use cases. Official docs: TextUs Next API

API gotchas

  • TextUs’s API tokens never expire and are scoped to the single user that created them, with full access to every feature available in that user’s account. There is no way to narrow a token’s scope.
  • The API requires content negotiation: send both Accept: application/vnd.textus+jsonld and Content-Type: application/vnd.textus+jsonld on every request. Standard application/json headers are rejected. Nango’s proxy sets these by default for this integration.
  • The API is Hydra/JSON-LD based — list responses come back as hydra:Collection objects (with hydra:member and hydra:totalItems) rather than a bare array, and paging follows hydra:PartialCollectionView.
  • Most endpoints are scoped under an account slug in the path, e.g. /{account}/contacts, /{account}/campaigns. A few resource-by-ID endpoints (e.g. /contacts/{contact}/notes, /groups/{group}/contacts) omit the account prefix since the ID itself is already unique. Copy the exact path from the endpoint’s docs page rather than assuming every endpoint follows the same pattern.
  • GET /accounts lists every account the connected user has a membership in (including via account hierarchies) — use it to discover the account slug(s) to use in scoped endpoint paths, since TextUs’s own docs never state a fixed one.
Contribute API gotchas by editing this page

Pre-built syncs & actions for TextUs

Enable them in your dashboard. Extend and customize to fit your needs. No pre-built syncs or actions available yet.
Not seeing the integration you need? Build your own independently.