Developer Guide
Developer Introduction
Get started with SuitePortal development and API integration
Developer Introduction
SuitePortal provides APIs and integration points for developers to access synced NetSuite data programmatically.
Architecture Overview
NetSuite SuitePortal Your Application
│ │ │
├─ SuiteBundle syncs ─────► │ │
│ (Map/Reduce) │ │
│ ├─ REST API ──────────────────► │
│ │ (read-only) │
│ │ │
│ ├─ MCP Server ────────────────► │
│ │ (AI/LLM access) │
│ │ │What's Available
| Feature | Description |
|---|---|
| REST API | Read-only access to transaction data |
| API Keys | Scoped authentication for API access |
| MCP Server | Model Context Protocol for AI integrations |
| Webhooks | TODO: Not yet implemented |
API Capabilities
The SuitePortal API provides read-only access to synced data:
| Operation | Supported |
|---|---|
| Read transactions | ✓ |
| Read entities | Planned |
| Create records | — |
| Update records | — |
| Delete records | — |
To modify data, make changes in NetSuite and sync.
Authentication Methods
| Method | Use Case |
|---|---|
| API Keys | Server-to-server API calls |
| Session Cookies | Browser-based portal access |
| OAuth (MCP) | AI/LLM integrations via MCP |
What's in This Section
- API Reference - REST API endpoints and usage
- Authentication - Authentication methods and API keys
- API Keys - Creating and managing API keys
- NetSuite Integration - Bundle installation and sync setup
Getting Started
- Create an API key in your SuitePortal dashboard
- Read the API Overview to understand available endpoints
- Make your first API call to fetch transaction data
Base URL
https://suiteportal.io/api/v1Quick Example
curl -X GET "https://suiteportal.io/api/v1/invoices?page=1&pageSize=10" \
-H "Authorization: Bearer sp-1703123456789-abc123def456"SDKs and Libraries
Official SDKs are not yet available. Use standard HTTP clients:
| Language | Recommended Library |
|---|---|
| JavaScript/TypeScript | fetch, axios |
| Python | requests, httpx |
| Go | net/http |
| Ruby | Net::HTTP, Faraday |
Rate Limits
Rate limiting is currently disabled. Fair usage policies apply.
Support
For API issues or questions:
- Email: trey@suiteportal.io
- Documentation: This site