> ## Documentation Index > Fetch the complete documentation index at: https://leadping.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Switch current organization account context > Switches the authenticated user's active organization context so subsequent lead, billing, and communication requests target that organization. ## OpenAPI ````yaml /openapi.json post /organizations/me/switch openapi: 3.0.4 info: title: Leadping API description: >- Leadping API for lead intake, messaging, calling, automations, billing, organization settings, and compliant lead communication workflows. license: name: MIT url: https://opensource.org/licenses/MIT version: v1 servers: - url: https://api.leadping.ai description: Production security: [] tags: - name: Analytics - name: Automations - name: Contact - name: Conversations - name: Feedback - name: Leads - name: LeadStatusChanges - name: LeadStatuses - name: Notifications - name: OutboundDelivery - name: Sources - name: Suppressions - name: Tags - name: Users - name: Calls - name: PhoneNumbers - name: Sms - name: Telephony - name: Organizations - name: UserDataExports - name: CallEvents - name: Events - name: SmsEvents - name: PaymentMethods - name: Transactions - name: Usage - name: Wallets paths: /organizations/me/switch: post: tags: - Organizations summary: Switch current organization account context description: >- Switches the authenticated user's active organization context so subsequent lead, billing, and communication requests target that organization. operationId: Organizations_SwitchCurrentOrganization requestBody: description: The selected organization identifier. content: application/json: schema: allOf: - $ref: '#/components/schemas/OrganizationSwitchRequest' description: >- Request schema for the Leadping API organization switch request, including the fields clients can send. application/*+json: schema: allOf: - $ref: '#/components/schemas/OrganizationSwitchRequest' description: >- Request schema for the Leadping API organization switch request, including the fields clients can send. required: true responses: '200': description: Returns the organization response. content: application/json: schema: allOf: - $ref: '#/components/schemas/OrganizationResponse' description: >- Response schema for the Leadping API organization profile response returned to authenticated clients. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: The authenticated user is not authorized for this operation. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' components: schemas: OrganizationSwitchRequest: type: object properties: organizationId: type: string description: Organization ID to switch into for the current Leadping session. description: >- Request schema for the Leadping API organization switch request, including the fields clients can send. OrganizationResponse: type: object properties: secondaryName: type: string description: Alternate organization name or DBA shown in Leadping. nullable: true user: type: object allOf: - $ref: '#/components/schemas/IdNamePair' description: User summary connected to this organization profile response. nullable: true accountBalance: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ description: Current wallet balance available to the organization. format: double billingPlan: enum: - Annual - Monthly type: string description: Defines the supported Billing Plan values. nullable: true subscriptionStatus: enum: - Pending - Active - Overdue - Canceled type: string description: Defines the supported Subscription Status values. nullable: true billingState: type: object allOf: - $ref: '#/components/schemas/OrganizationBillingState' description: Customer-safe billing state for this organization. nullable: true autoRefillEnabled: type: boolean description: >- Indicates whether automatic wallet refill is enabled for the organization. autoRefillAmount: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ description: Wallet refill amount charged when automatic refill is triggered. format: double autoRefillTrigger: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ description: Wallet balance threshold that triggers automatic refill. format: double status: enum: - SettingUp - SetupCompleted - Active type: string description: Defines the supported Organization Status values. nullable: true setupStatus: enum: - Personal - Organization - Details - Compliance - Phone - Plan - Billing - Review - Complete type: string description: Defines the supported User Setup Status values. nullable: true enabled: type: boolean description: >- Indicates whether this organization profile response is active and available in the Leadping API. phone: type: string description: >- Phone details for the lead, user, or organization represented by this organization profile response. nullable: true website: type: string description: >- Organization website URL used for compliance, brand review, and lead attribution. nullable: true address: type: object allOf: - $ref: '#/components/schemas/StreetAddress' description: >- Postal address for the organization, lead, or contact represented by this organization profile response. nullable: true billingName: type: string description: >- Name used for invoices, receipts, and payment processor billing records. nullable: true billingAddress: type: object allOf: - $ref: '#/components/schemas/StreetAddress' description: >- Postal address used for invoices, receipts, and payment processor billing records. nullable: true billingTaxId: type: string description: >- Tax identifier printed on billing documents. This may differ from the organization verification EIN. nullable: true vertical: type: string description: >- Industry vertical used for lead routing, compliance review, and reporting. nullable: true description: type: string description: >- Human-readable description that explains this organization profile response to API users. nullable: true ein: type: string description: >- Employer Identification Number used for organization and 10DLC verification. nullable: true einDocument: type: object allOf: - $ref: '#/components/schemas/IdNameValue' description: Uploaded EIN document reference used for organization verification. nullable: true domain: type: string description: >- Domain name connected to the organization website or activation workflow. nullable: true phones: type: array items: allOf: - $ref: '#/components/schemas/IdNameValue' description: >- A minimal Record type with an Id (string), Name (string), nullable Value (string?) and maximum JSON compatibility description: Phone numbers assigned to this organization. nullable: true site: type: object allOf: - $ref: '#/components/schemas/IdNamePair' description: Leadping website record connected to this organization. nullable: true setupStep: enum: - DomainFinding - DomainOptionsFound - SiteGenerating - SiteGenerated - BrandSubmitted - BrandApproved - CampaignSubmitted - CampaignApproved - CarrierReviewing - TenDlcComplete - Complete type: string description: Defines the supported Organization Setup Step values. nullable: true activation: type: object allOf: - $ref: '#/components/schemas/OrganizationActivationState' description: >- Organization activation state covering site, billing, compliance, and telephony readiness. nullable: true compliancePolicy: type: object allOf: - $ref: '#/components/schemas/OrganizationCompliancePolicy' description: Compliance policy configuration for the organization. nullable: true name: type: string description: The display name for the entity. id: type: string description: The unique identifier for the entity. createdAt: type: string description: The date and time when the entity was created. format: date-time modifiedAt: type: string description: The date and time when the entity was last modified, if applicable. format: date-time nullable: true description: >- Response schema for the Leadping API organization profile response returned to authenticated clients. ProblemDetails: type: object properties: type: type: string description: URI reference that identifies the problem type. nullable: true title: type: string description: Short, human-readable summary of the problem. nullable: true status: pattern: ^-?(?:0|[1-9]\d*)$ description: HTTP status code returned for the problem. format: int32 detail: type: string description: >- Human-readable explanation specific to this occurrence of the problem. nullable: true instance: type: string description: >- URI reference that identifies this specific occurrence of the problem. nullable: true IdNamePair: required: - id - name type: object properties: id: type: string description: The unique identifier. name: type: string description: The display name. description: >- A minimal Record type with an (string), (string), and maximum JSON compatibility. The reason for this type (over something like KeyValuePair, dictionary) is because of JSON serialization support. OrganizationBillingState: type: object properties: hasStripeCustomer: type: boolean description: Indicates whether the organization has a Stripe customer account. hasPaymentMethod: type: boolean description: >- Indicates whether the organization has a saved default payment method. phoneNumberQuantity: pattern: ^-?(?:0|[1-9]\d*)$ description: >- Gets or sets the number of phone numbers included in the organization subscription. format: int64 organizationMemberQuantity: pattern: ^-?(?:0|[1-9]\d*)$ description: >- Gets or sets the number of user licenses included in the organization subscription. format: int64 organizationMemberAssignedQuantity: pattern: ^-?(?:0|[1-9]\d*)$ description: >- Gets or sets the number of user licenses currently assigned by the organization. format: int64 pendingBillingPlan: enum: - Annual - Monthly type: string description: Defines the supported Billing Plan values. nullable: true billingPlanChangeEffectiveAt: type: string description: Date and time when the scheduled billing plan change takes effect. format: date-time nullable: true planRenewalAt: type: string description: Current plan renewal date. format: date-time nullable: true planPeriodStartAt: type: string description: Start of the current plan billing period. format: date-time nullable: true cancelAt: type: string description: Gets or sets when the active subscription is scheduled to cancel. format: date-time nullable: true dunning: type: object allOf: - $ref: '#/components/schemas/OrganizationDunningInfo' description: >- Gets or sets the customer-safe payment recovery state for the organization. nullable: true lastSubscriptionEventAt: type: string description: >- Gets or sets when Leadping last processed a subscription event for the organization. format: date-time nullable: true lastPaymentMethodEventAt: type: string description: >- Gets or sets when Leadping last processed a payment-method event for the organization. format: date-time nullable: true description: Customer-safe billing state for a Leadping organization. StreetAddress: type: object properties: line1: type: string description: >- The primary address line (e.g., street address, P.O. box, company name). nullable: true line2: type: string description: >- The secondary address line (e.g., apartment, suite, unit, or building). nullable: true city: type: string description: The city, town, or locality. nullable: true state: type: string description: >- The state, province, or equivalent administrative region. Commonly used in countries like the US, Canada, and Australia. nullable: true province: type: string description: >- The province or territory, if distinct from state in your use case (optional, use with care). nullable: true region: type: string description: >- The broader region, district, or administrative area (e.g., prefecture or county). nullable: true postalCode: type: string description: The postal or ZIP code. nullable: true country: type: string description: The ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA"). nullable: true additionalInfo: type: string description: Optional additional notes or delivery instructions. nullable: true description: >- A minimal, serializable record type for physical mailing addresses, with support for international formats and compatibility with common APIs. IdNameValue: required: - id - name type: object properties: value: type: string description: The optional value associated with the identifier and name. nullable: true id: type: string description: The unique identifier. name: type: string description: The display name. description: >- A minimal Record type with an Id (string), Name (string), nullable Value (string?) and maximum JSON compatibility OrganizationActivationState: type: object properties: status: allOf: - $ref: '#/components/schemas/CustomerActivationStatus' description: The current status for this organization activation state. onboardingStatus: allOf: - $ref: '#/components/schemas/ActivationOnboardingStatus' description: >- The current onboarding status for this organization activation state. paymentStatus: allOf: - $ref: '#/components/schemas/ActivationPaymentStatus' description: The current payment status for this organization activation state. billingSubscriptionStatus: allOf: - $ref: '#/components/schemas/ActivationSubscriptionStatus' description: >- The current billing subscription status for this organization activation state. launchReviewStatus: allOf: - $ref: '#/components/schemas/ActivationLaunchReviewStatus' description: >- The current launch review status for this organization activation state. controlledLaunch: type: boolean description: >- Whether controlled launch applies to this organization activation state. telephonyStatus: allOf: - $ref: '#/components/schemas/ActivationTelephonyStatus' description: The current telephony status for this organization activation state. websiteStatus: allOf: - $ref: '#/components/schemas/WebsiteLifecycleStatus' description: The current website status for this organization activation state. tenDlcStatus: allOf: - $ref: '#/components/schemas/TenDlcApplicationStatus' description: The current 10DLC status for this organization activation state. tenDlcApplicationId: type: string description: >- Identifier of the first-class 10DLC application entity for this organization. nullable: true customerFacingStatus: type: string description: >- The current customer facing status for this organization activation state. paymentMethodConfirmedAt: type: string description: >- The date and time for the payment method confirmed at value on this organization activation state. format: date-time nullable: true subscriptionPendingAt: type: string description: >- The date and time for the subscription pending at value on this organization activation state. format: date-time nullable: true subscriptionActiveAt: type: string description: >- The date and time for the subscription active at value on this organization activation state. format: date-time nullable: true launchReviewRequestedAt: type: string description: >- The date and time for the launch review requested at value on this organization activation state. format: date-time nullable: true launchApprovedAt: type: string description: >- The date and time for the launch approved at value on this organization activation state. format: date-time nullable: true telephonyProvisioningStartedAt: type: string description: >- The date and time for the telephony provisioning started at value on this organization activation state. format: date-time nullable: true telephonyPartiallyProvisionedAt: type: string description: >- The date and time for the telephony partially provisioned at value on this organization activation state. format: date-time nullable: true telephonyReadyAt: type: string description: >- The date and time for the telephony ready at value on this organization activation state. format: date-time nullable: true failedAt: type: string description: >- The date and time for the failed at value on this organization activation state. format: date-time nullable: true activatedAt: type: string description: >- The date and time for the activated at value on this organization activation state. format: date-time nullable: true industry: type: string description: The industry value for this organization activation state. nullable: true organizationDescription: type: string description: >- The organization description value for this organization activation state. nullable: true targetAudience: type: string description: The target audience value for this organization activation state. nullable: true offer: type: string description: The offer value for this organization activation state. nullable: true websiteNeeds: type: string description: The website needs value for this organization activation state. nullable: true serviceArea: type: string description: The service area value for this organization activation state. nullable: true complianceNotes: type: string description: The compliance notes value for this organization activation state. nullable: true domainOptions: type: array items: allOf: - $ref: '#/components/schemas/ActivationDomainOption' description: >- API DTO containing activation domain option data used by Leadping API contracts. description: The domain options included with this organization activation state. domainSearchStage: enum: - Queued - AskingOpenAi - CheckingCloudflare - Ranking - Complete - Failed type: string description: Defines the stages of a domain search. nullable: true domainSearchId: type: string description: Identifies the active domain search run. nullable: true domainSearchAttempt: pattern: ^-?(?:0|[1-9]\d*)$ description: The current domain generation attempt. format: int32 availableDomainCount: pattern: ^-?(?:0|[1-9]\d*)$ description: >- The number of registrar-verified domains found by the current search. format: int32 domainSearchUpdatedAt: type: string description: The last time domain search progress changed. format: date-time nullable: true selectedDomain: type: string description: The selected domain value for this organization activation state. nullable: true domainApprovedAt: type: string description: >- The date and time for the domain approved at value on this organization activation state. format: date-time nullable: true domainPurchasedAt: type: string description: The date and time the selected domain was purchased. format: date-time nullable: true websiteGenerationResult: type: string description: The latest persisted website generation progress message. nullable: true websiteUrl: type: string description: The URL associated with this organization activation state. nullable: true tenDlcDraft: type: object allOf: - $ref: '#/components/schemas/TenDlcApplicationDraft' description: The 10DLC draft value for this organization activation state. nullable: true events: type: array items: allOf: - $ref: '#/components/schemas/ActivationTimelineEvent' description: >- API DTO containing activation timeline event data used by Leadping API contracts. description: The events included with this organization activation state. createdAt: type: string description: >- The date and time for the created at value on this organization activation state. format: date-time updatedAt: type: string description: >- The date and time for the updated at value on this organization activation state. format: date-time description: >- API DTO containing organization activation state data used by Leadping API contracts. OrganizationCompliancePolicy: type: object properties: enabled: type: boolean description: Whether this organization compliance policy is enabled. allowedStates: type: array items: type: string description: >- The allowed states included with this organization compliance policy. allowedProducts: type: array items: type: string description: >- The allowed products included with this organization compliance policy. requireLeadState: type: boolean description: Whether this organization compliance policy requires lead state. requireAgentLicenseState: type: boolean description: >- Whether this organization compliance policy requires agent license state. requireProduct: type: boolean description: Whether this organization compliance policy requires product. requireTrustedFormForAutomations: type: boolean description: >- Whether this organization compliance policy requires TrustedForm for automations. requireSourceComplianceApproval: type: boolean description: >- Whether this organization compliance policy requires source compliance approval. description: >- API DTO containing organization compliance policy data used by Leadping API contracts. OrganizationDunningInfo: type: object properties: stage: type: string description: Current stage for this Leadping organization dunning info. nullable: true paymentFailedAt: type: string description: >- Date and time when this Leadping organization dunning info was payment failed. format: date-time nullable: true lastFailedInvoiceStatus: type: string description: >- Current last failed invoice status for this Leadping organization dunning info. nullable: true retryAttemptCount: pattern: ^-?(?:0|[1-9]\d*)$ description: >- Total number of retry attempt records represented by this Leadping organization dunning info. format: int32 nextRetryAt: type: string description: Date and time when the next retry is scheduled. format: date-time nullable: true gracePeriodEndsAt: type: string description: >- Date and time when this Leadping organization dunning info was grace period ends. format: date-time nullable: true outboundRestrictedAt: type: string description: >- Date and time when this Leadping organization dunning info was outbound restricted. format: date-time nullable: true outboundSuspendedAt: type: string description: >- Date and time when this Leadping organization dunning info was outbound suspended. format: date-time nullable: true finalCancellationAt: type: string description: >- Date and time when this Leadping organization dunning info was final cancellation. format: date-time nullable: true lastUpdatedAt: type: string description: >- Date and time when this Leadping organization dunning info was last updated. format: date-time nullable: true description: Dunning state recorded after a failed recurring payment. CustomerActivationStatus: enum: - DraftOnboarding - PaymentMethodPending - PaymentMethodConfirmed - SubscriptionPending - SubscriptionReceived - SubscriptionActive - LaunchReviewPending - TelephonyProvisioningPending - TelephonyPartiallyProvisioned - TelephonyReady - AwaitingReview - DomainSelection - WebsiteSetup - ComplianceRegistration - ReadyForApproval - Active - Failed - Blocked - BlockedRequiresOperatorAction - ManuallyBypassed type: string description: Defines the supported Customer Activation Status values. ActivationOnboardingStatus: enum: - Draft - Submitted - Failed type: string description: Defines the supported Activation Onboarding Status values. ActivationPaymentStatus: enum: - PaymentMethodPending - PaymentMethodConfirmed - Failed type: string description: Defines the supported Activation Payment Status values. ActivationSubscriptionStatus: enum: - Pending - Active - Failed - Canceled type: string description: Defines the supported Activation Subscription Status values. ActivationLaunchReviewStatus: enum: - NotReady - Pending - Approved - NotRequired - Blocked type: string description: Defines the supported Activation Launch Review Status values. ActivationTelephonyStatus: enum: - NotStarted - ProvisioningPending - PartiallyProvisioned - Ready - Failed - BlockedRequiresOperatorAction type: string description: Defines the supported Activation Telephony Status values. WebsiteLifecycleStatus: enum: - NotStarted - DomainSuggestionsPending - DomainSelectionPending - DomainPurchasePending - DomainPurchased - WebsiteGenerationQueued - WebsiteGenerating - WebsiteDeploymentQueued - WebsiteDeploying - WebsiteLive - WebsiteFailed - ManuallyBypassed type: string description: Defines the supported Website Lifecycle Status values. TenDlcApplicationStatus: enum: - NotStarted - DraftGenerated - DraftIncomplete - ReadyToSubmit - Submitted - PendingTelnyxReview - Approved - Rejected - NeedsChanges - ResubmissionReady - Failed type: string description: Defines the supported 10DLC Application Status values. ActivationDomainOption: type: object properties: domainName: type: string description: The domain name associated with this activation domain option. whyItFits: type: string description: The why it fits value for this activation domain option. industryRelevance: type: string description: The industry relevance value for this activation domain option. trustConcerns: type: string description: The trust concerns value for this activation domain option. nullable: true estimatedAnnualCost: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ description: The estimated annual cost value for this activation domain option. format: double availabilityStatus: type: string description: The current availability status for this activation domain option. recommended: type: boolean description: Whether this activation domain option is recommended. description: >- API DTO containing activation domain option data used by Leadping API contracts. TenDlcApplicationDraft: type: object properties: companyName: type: string description: The company name value for this 10DLC application draft. nullable: true contactName: type: string description: The contact name value for this 10DLC application draft. nullable: true contactEmail: type: string description: The contact email value for this 10DLC application draft. nullable: true contactPhone: type: string description: The contact phone value for this 10DLC application draft. nullable: true ein: type: string description: The EIN value for this 10DLC application draft. nullable: true websiteUrl: type: string description: The URL associated with this 10DLC application draft. nullable: true industry: type: string description: >- The Telnyx brand vertical for this 10DLC application draft. The JSON name is retained for backward compatibility. nullable: true useCase: type: string description: The use case value for this 10DLC application draft. nullable: true useCaseDescription: type: string description: The use case description value for this 10DLC application draft. nullable: true messageExamples: type: array items: type: string description: The message examples included with this 10DLC application draft. optInLanguage: type: string description: The opt in language value for this 10DLC application draft. nullable: true privacyPolicyUrl: type: string description: The URL associated with this 10DLC application draft. nullable: true termsUrl: type: string description: The URL associated with this 10DLC application draft. nullable: true expectedMonthlyVolume: pattern: ^-?(?:0|[1-9]\d*)$ description: The expected monthly volume value for this 10DLC application draft. format: int32 leadSource: type: string description: The lead source value for this 10DLC application draft. nullable: true trustedFormRequired: type: boolean description: >- Whether TrustedForm required applies to this 10DLC application draft. complianceWarnings: type: array items: type: string description: The compliance warnings included with this 10DLC application draft. missingFields: type: array items: type: string description: The missing fields included with this 10DLC application draft. brandStatus: allOf: - $ref: '#/components/schemas/TenDlcRegistrationStatus' description: The current provider review status for the submitted brand. campaignStatus: allOf: - $ref: '#/components/schemas/TenDlcRegistrationStatus' description: The current provider review status for the submitted campaign. lastSubmittedAt: type: string description: >- The date and time for the last submitted at value on this 10DLC application draft. format: date-time nullable: true rejectionReason: type: string description: >- The human-readable rejection reason explaining this 10DLC application draft. nullable: true updatedAt: type: string description: >- The date and time for the updated at value on this 10DLC application draft. format: date-time nullable: true version: pattern: ^-?(?:0|[1-9]\d*)$ description: The version value for this 10DLC application draft. format: int32 description: >- API DTO containing ten dlc application draft data used by Leadping API contracts. ActivationTimelineEvent: type: object properties: id: type: string description: The unique ID for this activation timeline event. type: type: string description: The type classification for this activation timeline event. title: type: string description: The title value for this activation timeline event. details: type: string description: The details value for this activation timeline event. nullable: true status: type: string description: The current status for this activation timeline event. actor: type: object allOf: - $ref: '#/components/schemas/IdNamePair' description: The ID and name for this actor. nullable: true failureReason: type: string description: >- The human-readable failure reason explaining this activation timeline event. nullable: true createdAt: type: string description: >- The date and time for the created at value on this activation timeline event. format: date-time description: >- API DTO containing activation timeline event data used by Leadping API contracts. TenDlcRegistrationStatus: enum: - NotSubmitted - Pending - Approved - Rejected - Failed type: string description: >- Defines the provider lifecycle for an individual 10DLC brand or campaign. ````