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:

​

Example Request

Here’s how you might create a new organization:

curl https://api.straddle.com/v1/organizations \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Global Tech Solutions",
    "metadata": {
      "industry": "Information Technology",
      "size": "Enterprise",
      "headquarters": "San Francisco"
    },
    "external_id": "GTS-2023"
  }'

​

Response

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

​

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

​

Example Request

Here’s how you might list your organizations:

curl https://api.straddle.com/v1/organizations?page_size=5&sort_by=name \
  -H "Authorization: Bearer YOUR_API_KEY"

​

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: