How will data be shared with our server?

(Polling strategy only) From where should TRMNL fetch data? (JSON, XML, plaintext)
Example: https://myapp.ai/dashboard?api_key=xxx

How should our API request data?

(Polling strategy only) What HTTP headers should be included?
Example: authorization=bearer xxx&content-type=application/json

(Polling strategy only) What body payload should be included?
Example: {"sortBy":"date"}

(Polling strategy only) Connect to third-party services requiring OAuth2

Add this URL to your OAuth app's "Redirect URIs" or "Callback URLs"

Configure your OAuth provider credentials and settings

Select a pre-configured provider to auto-fill OAuth settings, or configure manually

From your OAuth provider app settings
Example: your-client-id

Keep this secret!
Example: your-client-secret

OAuth2 authorization endpoint
Example: https://accounts.provider.com/oauth2/authorize

OAuth2 token endpoint
Example: https://accounts.provider.com/oauth2/token

List of scopes
Example: read user:email

Use Proof Key for Code Exchange (required by some providers like Twitter/X)

Extra parameters for the authorization URL
Example: {"token_access_type": "offline"}

Extra headers for the token request
Example: {"Notion-Version": "2022-06-28"}

Only needed if token endpoint is on a different domain than authorization
Example: https://swd.weatherflow.com

Extra body parameters for the token request
Example: {"type": "web_server"}

Character used to join multiple scopes

How to send client credentials during token exchange

Content type for token request body

Different endpoint for token refresh (optional)
Example: https://api.example.com/oauth/refresh

Extra fields to extract from the token response
Example: ["workspace_id", "owner"]

How to send client credentials to the authorization endpoint

Extra parameters for token refresh requests
Example: {"grant_type": "refresh_token"}

Field name in the OAuth response containing the access token
Example: access_token

Field name in the OAuth response containing the expiration
Example: expires_in

How to interpret the expiration value

Fixed token expiry in milliseconds (when not provided in response)
Example: 3600000

Learn how to build form fields here, or click here to verify syntax inline.
Example: - keyname: lookback_period field_type: select options: - '1' - '7' - '14' - '30' name: Lookback Period description: Time span of displayed data help_text: In days

(Static strategy only) Input valid JSON data
Example: {"upcoming_holidays":[{"date":"2025-02-14","name":"Holiday to Taj Mahal, India"},{"date":"2025-06-11","name":"Visiting Japan"},{"date":"2025-12-20","name":"Northern Lights Norway!"}]}

Defaults no. If "yes" is selected, padding around your markup will be removed.

Inverts black/white pixels. Will modify entire screen. Add class "image" to img tags as needed.

(Webhook strategy only) Paste this URL into your webhook integration