Meta tags:
description=Use the Loops REST API to manage contacts, send events, and send transactional email. Learn authentication, rate limits, and request/response examples.;

Headings (most frequently used words):

transactional, list, get, email, create, contact, update, campaign, api, group, key, groups, audience, message, send, theme, component, handling, suppression, properties, mailing, lists, campaigns, segments, upload, themes, components, workflows, workflow, emails, rate, limiting, sdks, errors, responses, introduction, documentation, index, on, this, page, authentication, reference, test, find, delete, check, status, remove, for, property, segment, preview, complete, node, event, ensure, has, draft, publish, dedicated, sending, ip, addresses, debugging, openapi, spec, go, javascript, nuxt, php, ruby, learn, cli, guides, contacts, messages, uploads, events, configuration, cors, dealing, with, 401, unauthorized, invalid, 429, other, 400, level, some, body, or, value, is, longer, than, allowable, unofficial,

Text of the page (most frequently used words):
api (48), the (41), loops (25), your (24), and (22), transactional (21), key (20), you (20), for (17), email (17), #contact (15), get (15), requests (13), with (11), rate (11), limit (11), list (11), create (11), #response (10), campaign (10), are (9), this (9), update (9), emails (9), workflows (9), can (8), request (8), groups (8), send (8), sdks (7), events (7), campaigns (7), contacts (7), responses (6), using (6), use (6), group (6), manage (6), audience (6), page (5), sdk (5), into (5), official (5), app (5), openapi (5), our (5), per (5), make (5), components (5), themes (5), lists (5), properties (5), support (4), following (4), have (4), all (4), example (4), started (4), receive (4), that (4), headers (4), ratelimit (4), 429 (4), limiting (4), authorization (4), application (4), test (4), here (4), messages (4), segments (4), mailing (4), authentication (4), introduction (4), ruby (3), php (3), recommend (3), code (3), javascript (3), making (3), json (3), these (3), client (3), like (3), steps (3), team (3), means (3), value (3), body (3), too (3), maximum (3), check (3), ensure (3), sure (3), handling (3), current (3), remaining (3), second (3), bearer (3), from (3), errors (3), side (3), debugging (3), number (3), workflow (3), view (3), component (3), theme (3), upload (3), uploads (3), message (3), https (3), reference (3), integrations (3), generated (2), contain (2), security (2), was (2), plutolinks (2), not (2), before (2), project (2), unofficial (2), nuxt (2), yaml (2), documents (2), postman (2), see (2), spec (2), further (2), including (2), please (2), some (2), delete (2), level (2), there (2), will (2), information (2), about (2), wrong (2), details (2), 400 (2), provide (2), usage (2), many (2), should (2), header (2), settings (2), cors (2), status (2), successful (2), users (2), time (2), configuration (2), organize (2), trigger (2), complete (2), content (2), suppression (2), d2d561f5ff80136f69b4b5a31b9fb3c9 (2), curl (2), name (2), add (2), different (2), webhooks (2), copy (2), learn (2), examples (2), guides (2), search (2), documentation (2), index (2), may, mistakes, assistant, linkedin, next, previous, vulnerability, reporting, yes, helpful, last, modified, july, 2026, submit, daniel, friis, rails, laravel, community, submitted, been, officially, reviewed, endorsed, thoroughly, testing, reviewing, integrating, module, typescript, software, packages, built, top, easier, integrate, import, insomnia, endpoints, expected, quickly, followed, still, experiencing, issues, don, hesitate, assistance, reach, out, error, long, 500, characters, each, opening, closing, quotes, reduce, length, values, try, again, longer, than, allowable, type, post, put, correct, one, endpoint, trying, access, typically, indicate, problem, more, what, went, other, allows, exceeded, included, format, your_api_key, dealing, invalid, 401, unauthorized, does, cross, origin, made, avoid, issue, server, having, trouble, tool, sometimes, things, tips, help, debug, case, requires, higher, happy, discuss, needs, important, handle, implementing, retries, exponential, backoff, strategy, exceed, http, failed, window, every, quality, service, limited, certain, frame, baseline, dedicated, sending, addresses, publish, has, draft, event, node, nodes, reusable, retrieve, images, preview, segment, targeting, property, remove, find, base, url, accept, replace, own, teamname, company, success, true, when, call, set, token, suggest, purposes, revoke, any, trash, icon, creates, assign, human, readable, need, click, generate, never, used, exposed, end, prefer, low, setup, incoming, zapier, their, attributes, rest, limits, basics, recipes, creating, deliverability, getting, completion, auth, overview, cli, changelog, agent, skills, account, smtp, goals, editing, navigation, log, home, skip, main, file, discover, available, pages, exploring, fetch, docs, llms, txt,

Text of the page (random words):
api introduction loops documentation index fetch the complete documentation index at docs llms txt use this file to discover all available pages before exploring further skip to main content loops home page contact us log in loops search navigation api api introduction search k learn get started editing emails workflows events goals contacts transactional email integrations smtp account agent skills for loops security api api introduction api reference examples sdks webhooks api changelog cli overview auth campaigns completion components contact properties contacts email messages events lists themes transactional uploads workflows guides all guides getting started workflows deliverability integrations creating emails recipes email basics on this page authentication api reference api key contacts contact properties mailing lists campaigns campaign groups audience segments email messages uploads themes components workflows events transactional emails transactional groups configuration rate limiting debugging openapi spec sdks unofficial sdks api api introduction copy page use the loops rest api to manage contacts send events and send transactional email learn authentication rate limits and request response examples copy page you can use the loops api to add contacts to your loops audience update their attributes and send events to loops prefer a no code or low code setup use our integrations like zapier or make or trigger workflows using incoming webhooks authentication your loops api key should never be used client side or exposed to your end users authentication steps to get started you ll need an api key go to settings api in loops and click generate key this creates an api key you can assign it a human readable name we suggest using a different api key for different purposes you can revoke an api key at any time with the trash icon when making an api call add an authorization header and set the api key as a bearer token you can test your api key by making a get request to https app loops so api v1 api key if successful you will receive the following response success true teamname company name here s an example curl request replace d2d561f5ff80136f69b4b5a31b9fb3c9 with your own api key curl https app loops so api v1 api key h accept application json h authorization bearer d2d561f5ff80136f69b4b5a31b9fb3c9 api reference the base url for the api is https app loops so api api key test your api key test api key contacts manage contacts create contact update contact find contact delete contact check contact suppression status remove suppression for a contact contact properties manage contact properties create contact property list contact properties mailing lists view your mailing lists list mailing lists campaigns create and manage campaigns create campaign update campaign get campaign list campaigns campaign groups organize campaigns into groups create campaign group update campaign group get campaign group list campaign groups audience segments view audience segments for campaign targeting get audience segment list audience segments email messages manage the content of campaigns and transactional emails update email message get email message send a preview email message uploads upload images for email messages create upload complete upload themes retrieve email themes create theme update theme get theme list themes components reusable components for your emails create component update component get component list components workflows view workflows and workflow nodes list workflows get workflow get workflow node events send events to trigger workflows send event transactional emails create manage and send transactional emails send transactional email create transactional email update transactional email ensure transactional email has draft publish transactional email get transactional email list transactional emails transactional groups organize transactional emails into groups create transactional group update transactional group get transactional group list transactional groups configuration list dedicated sending ip addresses rate limiting to ensure the quality of service for all users our api is rate limited this means there s a limit to the number of requests your application can make to our api in a certain time frame the baseline rate limit is 10 requests per second per team rate limiting details to see your current usage we provide the following response headers in every api response x ratelimit limit the maximum number of requests you can make per second x ratelimit remaining the number of requests remaining in the current rate limit window here is an example of a successful response with rate limit headers if you exceed this limit you ll receive a response with http status 429 too many requests here is an example of a failed response with rate limit headers it s important to handle these 429 responses in your application we recommend implementing retries with an exponential backoff strategy if your use case requires a higher limit please contact support and we ll be happy to discuss your needs debugging sometimes things go wrong here are some tips to help you debug your api requests debugging steps if you are having trouble with the api we recommend using a tool like postman to test your requests handling cors errors the loops api does not support cross origin requests made from client side javascript to avoid cors errors make sure to issue your requests from a server side application dealing with 401 unauthorized invalid api key errors make sure you have generated an api key from settings api and that you are including it in your requests your api key should be included in the authorization header of your request following the format authorization bearer your_api_key handling rate limiting 429 responses the loops api allows a maximum of 10 requests per second per team if you receive a 429 too many requests response this means you have exceeded this limit the x ratelimit limit and x ratelimit remaining headers in the response can provide information about your current rate limit usage handling other 400 level responses 400 level responses typically indicate that there was a problem with the request the response body will contain more information about what went wrong so be sure to check it for details check on your request type get post put delete and ensure that you are using the correct one for the endpoint you are trying to access some body key or value is longer than allowable if you receive this error it means that a value in the request body is too long we support a maximum of 500 characters for each value including the opening and closing quotes please reduce the length of the values in your request and try again if you have followed these steps and are still experiencing issues don t hesitate to reach out to the loops team for further assistance openapi spec get started quickly with the loops api using our openapi documents you can import these documents into an api client like postman or insomnia to see and use all of our endpoints with example requests and expected responses yaml app loops so openapi yaml json app loops so openapi json sdks sdks are software packages built on top of the api making it easier to integrate into your project go the official go sdk for loops javascript the official javascript typescript sdk for loops nuxt the official nuxt module for loops php the official php sdk for loops ruby the official ruby sdk for loops unofficial sdks the following sdks are community submitted and have not been officially reviewed or endorsed by loops we recommend thoroughly testing and reviewing the code before integrating it into your project laravel by plutolinks php by plutolinks ruby on rails by daniel friis submit an sdk last modified on july 9 2026 was this page helpful yes no security and vulnerability reporting previous api key next i x linkedin assistant responses are generated using ai and may contain mistakes contact support