Get Contacts by List Name (Reply.io)
Reply → Get Contacts by List Name (Reply.io)
/v1/reply-get-contacts-by-list-name{ "list_name": "Jane Doe" }
{ "ok": true, "data": { "total": 1, "page": 1, "pages_count": 1, "id": "rec_4f3a91", "email": "[email protected]", "first_name": "sample", "last_name": "sample", "company": "sample", "title": "sample", "mobile_number": "sample", "city": "sample", "state": "sample", "country": 1, "linkedin_url": "https://acme.com", "adding_date": "sample", "next_page_url": "https://acme.com", "previous_page_url": "https://acme.com" } }
Retrieve a list of all contacts associated with a specific List Name from your Reply account.
Install
Add get contacts by list name (reply.io) to your MCP client.
Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__reply-get-contacts-by-list-name
When to use this.
The "Get Contacts by List Name" action from Reply.io enables users to efficiently retrieve all contacts associated with a specified list name within their Reply account. This integration action requires a single input parameter, "listName," which is a string representing the name of the contact list from which to extract data. Upon execution, the action returns a comprehensive set of output fields, including total contacts, current page, total pages, and detailed contact information such as ID, email, first name, last name, company name, job title, phone number, city, state, country, LinkedIn profile URL, and adding date. This functionality is particularly useful for sales and marketing teams looking to manage and segment their contact lists effectively, facilitating targeted outreach and personalized communication strategies. By leveraging this action, users can streamline their contact management processes and enhance their engagement efforts.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Get Contacts by List Name (Reply.io)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
totalTotalnullablenumberpagePagenullablenumberpages_countPages CountnullablenumberidIdnumberemailEmailstringfirst_nameFirst Namestringlast_nameLast NamestringcompanyCompanystringtitleTitlenullablestringmobile_numberMobile NumberstringcityCitynullablestringstateStatenullablestringcountryCountrynullablestringlinkedin_urlLinkedin Urlstringadding_dateAdding Datenullablestringnext_page_urlNext Page Urlnullablestringprevious_page_urlPrevious Page Urlnullablestring
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/reply-get-contacts-by-list-name. Auth: x-api-key.
/v1/reply-get-contacts-by-list-namecurl -X POST 'https://v3-api.texau.com/api/v1/reply-get-contacts-by-list-name' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"list_name":"Jane Doe"}'
{ "ok": true, "data": { "total": 1, "page": 1, "pages_count": 1, "id": "rec_4f3a91", "email": "[email protected]", "first_name": "sample", "last_name": "sample", "company": "sample", "title": "sample", "mobile_number": "sample", "city": "sample", "state": "sample", "country": 1, "linkedin_url": "https://acme.com", "adding_date": "sample", "next_page_url": "https://acme.com", "previous_page_url": "https://acme.com" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
integration
Push Existing Contact to Campaign (Reply.io)
Push an existing contact to a selected campaign. Note: The contact will only be moved if they are not currently in any active campaign.
Create Contact and Push to Campaign (Reply.io)
Create a contact and immediately push them to a specific campaign (sequence) in Reply.io.
Output
Results land in a TexAu table.
Sample rows below.
Real result preview coming soon.
| Input | Status | Score |
|---|---|---|
| [email protected] | valid | 96 |
| [email protected] | risky | 54 |
| [email protected] | invalid | 12 |
Workflow
A real example.
Trigger → get contacts by list name (reply.io) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Built for
Who runs this.
Reliability
Rate limits & reliability.
- Per-minute limitNo public cap
- Per-day limitPlan-defined
- RetriesAutomatic w/ backoff
- ModeSync
Errors
HTTP status codes.
What each response means and what to do about it.
| Code | Cause | Fix |
|---|---|---|
| 200 OK | Action ran. Data in `data`. | Read response. |
| 400 Bad Request | Missing or malformed input. | Validate against the input schema. |
| 401 Unauthorized | Missing or invalid `x-api-key`. | Re-issue from /api-platform. |
| 403 Forbidden | Workspace lacks plan tier. | Upgrade or contact sales. |
| 404 Not Found | Action key not recognized. | Verify the slug. |
| 429 Rate Limited | Per-minute or per-day cap hit. | Backoff; reduce concurrency. |
| 500 Server Error | Unexpected TexAu issue. | Retry with backoff. |
| 502 Bad Gateway | Upstream provider 5xx. | Retry; we surface root cause. |
| 504 Timeout | Upstream slower than maxLatency. | Switch to `isAsync` polling. |
Related
More Reply actions.
Push Existing Contact to Campaign (Reply.io)
Push an existing contact to a selected campaign. Note: The contact will only be moved if they are not currently in any active campaign.
Create Contact and Push to Campaign (Reply.io)
Create a contact and immediately push them to a specific campaign (sequence) in Reply.io.
FAQ.
Is this real-time?
Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).
Do I get charged on failure?
No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.
Does it work with Claude / Cursor via MCP?
Yes. Add the texau MCP server to your client config, then call `texau__reply-...` directly.
What CRMs can I push results to?
HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.
Run Get Contacts by List Name (Reply.io) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.