Bill Sandbox
Overview
Pre-built tooling
✅ Authorization
| Tools | Status |
|---|---|
| Pre-built authorization (Bill) | ✅ |
| Pre-built authorization UI | ✅ |
| Custom authorization UI | ✅ |
| End-user authorization guide | ✅ |
| Expired credentials detection | ✅ |
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | ✅ |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Tenklo on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
| Proxy requests | ✅ |
✅ Observability & data quality
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-end type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ Customization
| Tools | Status |
|---|---|
| Create or customize use-cases | ✅ |
| Pre-configured pagination | 🚫 (time to contribute: <48h) |
| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) |
| Per-customer configurations | ✅ |
Users
Others
| Function name | Description | Type | Source code |
|---|---|---|---|
create-user | Creates a user in Bill. | Action | 🔗 Github |
disable-user | Archive an existing user in Bill | Action | 🔗 Github |
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ |
Setup guide
No setup guide yet.
Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page
Useful links
Contribute useful links by editing this page
API gotchas
- If you would like to set up a sandbox API environment, one can sign up here. Once you have successfully created an account, please email the team and they will send you the API credentials.
- When creating a new connection in Tenklo, please provide the following: Username (the email address used to sign in to your BILL developer account), Password (used to sign in to your BILL developer account), Organization ID (a unique alphanumeric value beginning with 008 that represents your organization), and Developer key (provided by the team and used to identify your developer account in API requests).
- After creating a connection, you can use the credentials as follows;
const connection = await nango.getConnection();
// Initialize credentials object
let credentials: { session_id?: string; dev_key?: string } = {};
// Check for session ID and developer key
if ('session_id' in connection.credentials && 'dev_key' in connection.credentials) {
credentials = {
session_id: connection.credentials.session_id,
dev_key: connection.credentials.dev_key,
};
} else {
throw new nango.ActionError({
message: `Session ID and Developer Key are incomplete or missing`
});
}
// Define the configuration for the API call
const config: ProxyConfiguration = {
endpoint: 'users',
retries: 10,
paginate: {
type: 'cursor',
cursor_name_in_request: 'page',
cursor_path_in_response: 'nextPage',
response_path: 'results',
limit_name_in_request: 'max',
limit: 100
},
headers: {
sessionId: credentials.session_id,
devKey: credentials.dev_key
},
};Contribute API gotchas by editing this page
Connect to Bill.com
Guide to connect to Bill.com sandbox using Tenklo Connect.