@workwayco/integrations


Official WORKWAY integrations - concrete implementations built on BaseAPIClient.

> Zuhandenheit: The tool recedes; the outcome remains.

Installation

``bash
npm install @workwayco/integrations
`

Available Integrations (21+)

| Category | Integrations |
|----------|--------------|
| Productivity | Notion, Airtable, Google Sheets, Todoist, Linear |
| Communication | Slack, Discord |
| CRM & Sales | HubSpot, Follow Up Boss |
| Payments | Stripe, QuickBooks |
| Scheduling | Zoom, Calendly |
| Developer | GitHub |
| Forms | Typeform |
| Design | Dribbble |
| Documents | DocuSign |
| Video | YouTube |
| Healthcare | NexHealth, Weave, Sikka |
| Construction | Procore |

$3

`typescript
import { Slack } from '@workwayco/integrations/slack';
import { Notion } from '@workwayco/integrations/notion';
import { Stripe } from '@workwayco/integrations/stripe';
import { GitHub } from '@workwayco/integrations/github';
// ... etc
`

Usage

$3

`typescript
import { Gmail } from '@workwayco/integrations/gmail';

const gmail = new Gmail({ accessToken: tokens.access_token });

// List emails
const emails = await gmail.listEmails({ maxResults: 10 });
if (emails.success) {
for (const email of emails.data) {
console.log(email.snippet);
}
}

// Send email
const sent = await gmail.sendEmail({
to: 'user@example.com',
subject: 'Hello',
body: 'Message content',
});
`

$3

`typescript
import { Notion } from '@workwayco/integrations/notion';

const notion = new Notion({ accessToken: tokens.access_token });

// Search pages
const results = await notion.search({ query: 'Project' });

// Create page in database
const page = await notion.createPage({
parent: { database_id: 'abc123' },
properties: {
Name: { title: [{ text: { content: 'New Task' } }] },
Status: { select: { name: 'In Progress' } },
},
});
`

$3

`typescript
import { Slack } from '@workwayco/integrations/slack';

const slack = new Slack({ accessToken: tokens.access_token });

// Send message
await slack.sendMessage({
channel: '#general',
text: 'Hello from WORKWAY!',
});

// List channels
const channels = await slack.listChannels({ limit: 100 });
`

$3

`typescript
import { Stripe } from '@workwayco/integrations/stripe';

const stripe = new Stripe({ apiKey: process.env.STRIPE_SECRET_KEY });

// List payments
const payments = await stripe.listPayments({ limit: 10 });

// Create customer
const customer = await stripe.createCustomer({
email: 'user@example.com',
name: 'John Doe',
});
`

$3

`typescript
import { GoogleSheets } from '@workwayco/integrations/google-sheets';

const sheets = new GoogleSheets({ accessToken: tokens.access_token });

// Read values
const values = await sheets.getValues({
spreadsheetId: 'abc123',
range: 'Sheet1!A1:D10',
});

// Append row
await sheets.appendValues({
spreadsheetId: 'abc123',
range: 'Sheet1!A:D',
values: [['New', 'Row', 'Data', 'Here']],
});
`

ActionResult Pattern

All integrations return ActionResult for consistent error handling:

`typescript
const result = await gmail.listEmails({ maxResults: 10 });

if (result.success) {
// TypeScript knows result.data exists
console.log(result.data);
} else {
// Handle error
console.error(result.error.code, result.error.message);
}
`

Development

$3

`bash
pnpm test
`

$3

`bash
pnpm build
`

Building Custom Integrations

All integrations extend BaseAPIClient from @workwayco/sdk:

`typescript
import { BaseAPIClient } from '@workwayco/integrations';

export class MyService extends BaseAPIClient {
constructor(config: { accessToken: string }) {
super({
accessToken: config.accessToken,
apiUrl: 'https://api.myservice.com/v1',
errorContext: { integration: 'myservice' },
});
}

async getItems(): Promise> {
return this.getJson('/items');
}

async createItem(data: CreateItemInput): Promise> {
return this.postJson('/items', data);
}
}
``

This gives you:
- Automatic token refresh
- Consistent error handling
- Rate limiting
- Timeout management
- Type-safe responses

Links

- SDK: @workwayco/sdk
- Platform: workway.co
- GitHub: github.com/workwayco/workway

License

Apache-2.0