Agent skill
salesloft-hello-world
Create a minimal working SalesLoft example — list people and create a person. Use when starting a new SalesLoft integration, testing your setup, or learning the People and Cadences API patterns. Trigger: "salesloft hello world", "salesloft example", "salesloft quick start".
Install this agent skill to your Project
npx add-skill https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/main/plugins/saas-packs/salesloft-pack/skills/salesloft-hello-world
SKILL.md
SalesLoft Hello World
Overview
List people and create a new person — the two fundamental SalesLoft API operations. Uses the REST API v2 at https://api.salesloft.com/v2/. All endpoints return JSON with a data wrapper and support pagination via page and per_page params.
Prerequisites
- Valid OAuth token or API key (see
salesloft-install-auth) SALESLOFT_API_KEYenvironment variable set
Instructions
Step 1: List People
import axios from 'axios';
const api = axios.create({
baseURL: 'https://api.salesloft.com/v2',
headers: { Authorization: `Bearer ${process.env.SALESLOFT_API_KEY}` },
});
// List people — returns paginated results
const { data } = await api.get('/people.json', {
params: { per_page: 25, page: 1 },
});
console.log(`Total people: ${data.metadata.paging.total_count}`);
data.data.forEach((person: any) => {
console.log(` ${person.display_name} <${person.email_address}>`);
});
Step 2: Create a Person
// Create a new person record
const { data: created } = await api.post('/people.json', {
email_address: 'prospect@example.com',
first_name: 'Alex',
last_name: 'Johnson',
title: 'VP Engineering',
company_name: 'Acme Corp',
phone: '+1-555-0100',
city: 'Austin',
state: 'TX',
custom_fields: {
lead_source: 'website',
},
});
console.log(`Created person: ${created.data.id} — ${created.data.display_name}`);
Step 3: Add Person to a Cadence
// First, list available cadences
const { data: cadences } = await api.get('/cadences.json', {
params: { per_page: 10 },
});
const cadenceId = cadences.data[0].id;
// Add person to cadence
const { data: membership } = await api.post('/cadence_memberships.json', {
person_id: created.data.id,
cadence_id: cadenceId,
});
console.log(`Added to cadence: ${membership.data.cadence.name}`);
Output
Total people: 1,247
Alex Johnson <prospect@example.com>
Created person: 98765 — Alex Johnson
Added to cadence: Q1 Outbound Sequence
Error Handling
| Error | Cause | Solution |
|---|---|---|
422 Unprocessable Entity |
Missing required field (email) | Ensure email_address is provided |
409 Conflict |
Duplicate email address | Search existing people first with ?email_addresses[]= |
401 Unauthorized |
Invalid/expired token | Refresh OAuth token |
429 Too Many Requests |
Rate limit exceeded (600 cost/min) | Back off and retry after Retry-After header |
Examples
Search People by Email
const { data } = await api.get('/people.json', {
params: { email_addresses: ['prospect@example.com'] },
});
Update a Person
await api.put(`/people/${personId}.json`, {
title: 'CTO',
company_name: 'New Corp',
});
List Activities for a Person
const { data: activities } = await api.get('/activities/emails.json', {
params: { person_id: personId, per_page: 50 },
});
Resources
Next Steps
Proceed to salesloft-local-dev-loop for development workflow setup.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
dockerfile-generator
Dockerfile Generator - Auto-activating skill for DevOps Basics. Triggers on: dockerfile generator, dockerfile generator Part of the DevOps Basics skill category.
branch-naming-helper
Branch Naming Helper - Auto-activating skill for DevOps Basics. Triggers on: branch naming helper, branch naming helper Part of the DevOps Basics skill category.
readme-generator
Readme Generator - Auto-activating skill for DevOps Basics. Triggers on: readme generator, readme generator Part of the DevOps Basics skill category.
makefile-generator
Makefile Generator - Auto-activating skill for DevOps Basics. Triggers on: makefile generator, makefile generator Part of the DevOps Basics skill category.
gitignore-generator
Gitignore Generator - Auto-activating skill for DevOps Basics. Triggers on: gitignore generator, gitignore generator Part of the DevOps Basics skill category.
pre-commit-hook-setup
Pre Commit Hook Setup - Auto-activating skill for DevOps Basics. Triggers on: pre commit hook setup, pre commit hook setup Part of the DevOps Basics skill category.
Didn't find tool you were looking for?