Organizations

Organizations are a powerful feature in Straddle that allow you to manage multiple accounts under a single umbrella. This hierarchical structure is particularly useful for businesses with complex operations, multiple departments, or those managing payments for various clients.

​

Understanding Organizations

Think of an organization as the parent entity that can house multiple Straddle accounts. This structure offers several advantages:

1. Centralized Management: Oversee all your accounts from a single dashboard.
2. Streamlined Onboarding: Easily create new accounts using existing KYC information.
3. Consolidated Reporting: Get a holistic view of your business operations across all accounts.
4. Unified Team Management: Manage user roles and permissions at the organization level.
5. Cross-Account Search: Quickly find information across all your accounts.

​

Creating an Organization

To start leveraging the power of organizations, you first need to create one. Use the Create Organization endpoint to set up a new organization in Straddle.

​

Attributes

When creating an organization, you can specify the following attributes:

Field	Type	Description
name	string	The name of your organization. Choose something recognizable and unique.
metadata	object	Additional key-value pairs for storing extra information about the organization.
external_id	string	Your own unique identifier for the organization, useful for cross-referencing.

​

Example Request

Here’s how you might create a new organization:

​

Response

Upon successful creation, Straddle will respond with the details of the newly created organization:

Field	Type	Description
id	string	Straddle’s unique identifier for the organization.
name	string	The name you provided for the organization.
external_id	string	Your provided unique identifier for the organization.
metadata	object	The additional key-value pairs you provided.

​

Managing Organizations

Once you’ve created an organization, you can start adding accounts to it, managing team access, and leveraging its capabilities for streamlined operations.

​

Listing Organizations

To view all the organizations you’ve created, use the List Organizations endpoint. This is particularly useful when managing multiple organizations or when you need to retrieve a specific organization’s ID.

​

Query Parameters

Parameter	Type	Description
name	string	Filter organizations by name (supports partial matching).
external_id	string	Filter organizations by their external ID.
page_number	integer	The page number for paginated results (default: 1).
page_size	integer	Number of results per page (default: 100, max: 1000).
sort_by	string	Field to sort by (default: ‘id’).
sort_order	string	Sort order: ‘asc’ or ‘desc’ (default: ‘asc’).

​

Example Request

Here’s how you might list your organizations:

​

Best Practices

When working with organizations in Straddle, consider the following best practices:

​

Next Steps

Now that you understand how to create and manage organizations, you’re ready to start leveraging their power in Straddle. Here are some next steps you might consider: