# Appcircle

Appcircle is an enterprise-grade mobile CI/CD platform that enables developers to build, test, and publish mobile applications efficiently, offering both cloud-based and self-hosted deployment options.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 14
- **Triggers:** 0
- **Slug:** `APPCIRCLE`
- **Version:** 20260312_00

## Tools

### Standard Repo Webhook Callback

**Slug:** `APPCIRCLE_BUILD_REPO_WEBHOOK_CALLBACK_STANDARD`

Trigger Appcircle builds via Git provider webhook callbacks. This action forwards webhook payloads from GitHub, GitLab, Bitbucket, or Azure DevOps to Appcircle's build webhook endpoint to automatically trigger builds when code is pushed. Use this action when: - Simulating or testing webhook-triggered builds - Programmatically triggering builds using webhook payloads - Integrating custom CI/CD workflows that need to trigger Appcircle builds - Replaying or debugging webhook events Requirements: - The organization must exist and have webhook integration configured in Appcircle - Build profiles must be set up with repository connections - The webhook URL pattern is: https://api.appcircle.io/build/v1/callback/hooks/{provider}/{org_id}/V7 Note: The action returns the raw HTTP response including status code and response body, allowing you to handle success, validation errors, or authentication issues appropriately.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | Complete webhook payload from the Git provider. This should be the unmodified JSON body sent by GitHub (push event), GitLab (push/merge event), Bitbucket (repo:push event), or Azure DevOps (git.push event). The payload structure varies by provider but typically includes repository details, commit information, author data, and branch references. |
| `git_provider` | string ("github" | "gitlab" | "bitbucket" | "azuredevops") | Yes | Git provider segment from the webhook URL. Must match the provider that will send the webhook. Valid values: 'github' for GitHub, 'gitlab' for GitLab, 'bitbucket' for Bitbucket Cloud/Server, 'azuredevops' for Azure DevOps. |
| `organization_id` | string | Yes | Appcircle organization ID (UUID format) that identifies which organization's build profiles should be triggered. This must match the organization ID in your Appcircle webhook URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Custom Integration Webhook Callback

**Slug:** `APPCIRCLE_BUILD_WEBHOOK_CUSTOM_INTEGRATION`

Triggers Appcircle builds via custom integration webhook endpoint by forwarding Git provider webhook payloads. This action is designed to receive and forward webhook payloads from Git providers (GitHub, GitLab, Bitbucket, Azure DevOps) to Appcircle's build system. The webhook URL format and parameters (organization_id, integration_id, version) are provided by Appcircle when you configure custom integrations for repositories connected via SSH or public URL in the build profile settings. Use this action when: - You need to programmatically trigger Appcircle builds from Git provider webhook events - Testing webhook integrations with different payload structures - Implementing custom CI/CD workflows that forward webhook events to Appcircle Note: The organization_id and integration_id values must correspond to actual configurations in Appcircle. Test payloads will typically return 400/404 errors indicating no valid configuration exists for the provided IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | The complete webhook payload received from the Git provider (GitHub, GitLab, Bitbucket, or Azure DevOps). This should be the raw JSON object sent by the Git provider containing commit information, repository details, pusher data, and other event-specific fields. The payload structure varies by Git provider but typically includes fields like 'ref', 'commits', 'repository', 'pusher', and 'sender'. |
| `version` | string | Yes | The API version identifier from the webhook URL. Typically 'V' for standard webhooks or 'V7' for newer versions. This value is specified in the webhook URL provided by Appcircle. |
| `git_provider` | string ("github" | "gitlab" | "bitbucket" | "azure-devops") | Yes | The Git provider type for the webhook endpoint. Must be one of: 'github', 'gitlab', 'bitbucket', or 'azure-devops'. This value is part of the webhook URL provided by Appcircle when setting up custom integrations. |
| `integration_id` | string | Yes | The custom integration ID (UUID format) for your repository connection. This ID is part of the webhook URL provided by Appcircle when configuring custom integrations for repositories connected via SSH or public URL. Example format: 'abcdef12-3456-7890-abcd-ef1234567890' |
| `organization_id` | string | Yes | The unique Appcircle organization ID (UUID format). This ID is embedded in the webhook URL generated by Appcircle for your organization. Example format: '123e4567-e89b-12d3-a456-426614174000' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Distribution Profiles

**Slug:** `APPCIRCLE_DISTRIBUTION_LIST_PROFILES`

List all distribution profiles for the authenticated organization. Distribution profiles are used to manage and distribute app builds to testers. This endpoint supports pagination, sorting, and filtering by profile name. Use this when you need to retrieve available distribution profiles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). Must be >= 1. |
| `size` | integer | No | Number of items per page. Must be >= 1. |
| `sort` | string | No | Sorting parameter for the profiles list. Example: 'name', '-createDate' |
| `search` | string | No | Search term to filter profiles by name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Distribution Sent Profiles

**Slug:** `APPCIRCLE_GET_DISTRIBUTE_SENT_PROFILES`

Get distinct profile names for App Sharing Report filter. Returns a list of unique profile names that can be used to filter app sharing reports within the specified date range and organization. Use this to discover available profile names before querying detailed sharing reports.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `endDate` | string | No | End date for filtering profiles. Format: ISO 8601 date string (e.g., '2024-12-31T23:59:59Z'). |
| `startDate` | string | No | Start date for filtering profiles. Format: ISO 8601 date string (e.g., '2024-01-01T00:00:00Z'). |
| `organizationId` | string | No | Organization ID to filter profiles. If not provided, uses the authenticated user's organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Publish Activity Report

**Slug:** `APPCIRCLE_GET_PUBLISH_ACTIVITY_REPORT`

Retrieve the publish activity report for your organization. Returns paginated list of publish activities with filtering options by date range, platform, action type, and organization. Use this to monitor and audit publish operations across profiles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `Page` | integer | No | Page number for pagination. Must be >= 1. |
| `Size` | integer | No | Number of items per page. Must be >= 1. |
| `Sort` | string | No | Sort order for results. Use field name with optional prefix '+' for ascending or '-' for descending. |
| `email` | string | No | Filter by user email address who performed the action. |
| `action` | string ("None" | "PublishflowSaved" | "PublishSaved" | "PublishStepSaved" | "PublishStepFailed" | "PublishStepSuccess" | "PublishRestarting" | "PublishArchived" | "PublishRestartingCancelled" | "PublishStopped" | "PublishSuccess" | "PublishSucceededWithoutArtifacts" | "PublishFailed" | "PublishStepStarting" | "PublishStepStarted" | "CancelPublishStep" | "PublishStepStartingCancelled" | "ProfileCreated" | "AppVersionUploaded" | "AppVersionCreated" | "ProfileDeleted" | "AppVersionDeleted" | "MetaDataFileDeleted" | "MetaDataFileDeleting" | "MetaDataFileDeletingCancelled" | "MetaDataImporting" | "MetaDataImportingCancelled" | "MetaDataImported" | "MetaDataUploading" | "MetaDataUpdated" | "MetaDataUploaded" | "MetaDataUploadingCancelled" | "ResignCreating" | "ResignCreated" | "ResignCreatingCancelled" | "ResignSuccess" | "ResignFailed" | "ResignCancelled" | "MarkedAsReleaseCandidate" | "UnMarkedReleaseCandidate" | "ReleaseNoteUpdated" | "AppInfoStoreUpdateFailed" | "AppInfoStoreUpdatePartiallyFailed" | "AppInfoStoreUpdateSucceeded" | "AppVersionRejected" | "ReviewSubmissionCancelled") | No | Publish action type enumeration. |
| `endDate` | string | No | Filter activities up to this date. Use ISO 8601 format (e.g., '2024-12-31T23:59:59Z'). |
| `platform` | string ("unknown" | "ios" | "android") | No | Platform type enumeration. |
| `startDate` | string | No | Filter activities starting from this date. Use ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). |
| `profileName` | string | No | Filter by profile name. Supports partial matching. |
| `organizationId` | string | No | Filter by organization ID (UUID format). |
| `organizationName` | string | No | Filter by organization name. Supports partial matching. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Build Profiles

**Slug:** `APPCIRCLE_LIST_BUILD_PROFILES`

List all build profiles for the authenticated organization. Build profiles define the configuration for building mobile applications. Use this to discover available build profiles and their IDs before triggering builds or configuring webhooks.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bundle Identifiers

**Slug:** `APPCIRCLE_LIST_BUNDLE_IDENTIFIERS`

List all bundle identifiers in Appcircle. Returns all bundle identifiers configured in your organization, including their platforms, capabilities, and associated credentials. Use this to discover available bundle identifiers before managing signing identities or app configurations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organizations

**Slug:** `APPCIRCLE_LIST_ORGANIZATIONS`

List organizations accessible to the authenticated user. Returns a paginated list of organizations with their details including ID, name, logo URL, and SSO status. Supports search filtering and pagination controls. Use this to discover available organizations before performing organization-specific operations like managing builds, distributions, or webhooks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Must be >= 1. Default is 1. |
| `search` | string | No | Search query string to filter organizations by name. Supports Unicode characters. |
| `perPage` | integer | No | Number of items per page. Must be >= 1. Default is 200. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Store Profiles

**Slug:** `APPCIRCLE_LIST_STORE_PROFILES`

List all Enterprise App Store profiles for the authenticated organization. Enterprise App Store profiles are used to distribute apps internally. Use this to discover available store profiles and their IDs before listing app versions or managing store content.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Rename Variable Group

**Slug:** `APPCIRCLE_RENAME_VARIABLE_GROUP`

Tool to rename an environment group (variable group) in Appcircle. Use when you need to update the name of an existing variable group to better reflect its purpose or environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the variable group. If not provided, the group name will remain unchanged. |
| `variableGroupId` | string | Yes | Unique identifier of the variable group to rename. Must be a valid UUID format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Obtain In-App Update Auth Token

**Slug:** `APPCIRCLE_STORE_IN_APP_AUTH_TOKEN`

Tool to fetch an access token for Enterprise App Store in-app updates. Use when you have the enterprise store profileId and secret and need to obtain a bearer token for subsequent update requests.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `Secret` | string | Yes | In-App Update Secret key for authenticating with the Enterprise Store. Obtain this from your Enterprise App Store Profile settings. |
| `storeUrl` | string | Yes | Base URL of the Enterprise App Store (e.g., https://store.mycompany.com). This is the domain where in-app update APIs are served. |
| `ProfileId` | string | Yes | Enterprise Store Profile ID in GUID/UUID format (e.g., '12345678-1234-1234-1234-123456789012'). Find this in your Enterprise App Store Profile settings under the Info tab. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download In-App Update Version with User

**Slug:** `APPCIRCLE_STORE_IN_APP_DOWNLOAD_VERSION_WITH_USER`

Tool to download a specific in-app store version and attribute the download to a user for reporting. Use when triggering an in-app update download after obtaining an access token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `store_url` | string | Yes | Base URL of the Enterprise App Store (e.g., https://store.mycompany.com) |
| `userEmail` | string | Yes | End-user email to attribute the download for reporting |
| `versionId` | string | Yes | App version identifier (AppVersion.Id) |
| `accessToken` | string | Yes | In-app update access token obtained via /api/auth/token |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Enterprise App Store App Versions

**Slug:** `APPCIRCLE_STORE_INAPP_LIST_APP_VERSIONS`

Tool to list available app versions for the Enterprise App Store profile. Use when fetching available in-app update versions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `storeUrl` | string | Yes | Base URL of the Enterprise App Store (e.g., https://store.mycompany.com). This is the domain where in-app update APIs are served. |
| `accessToken` | string | No | Bearer access token obtained via /api/auth/token. If provided, will be set as Authorization header. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Store Profile App Versions V2

**Slug:** `APPCIRCLE_STORE_LIST_PROFILE_APP_VERSIONS_V2`

Tool to list app versions under a given store profile. Use when you need to fetch all versions for a specific Enterprise App Store profile after obtaining its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `accept` | string | No | Optional Accept header override (default application/json). |
| `profileId` | string | Yes | Enterprise App Store profile ID in UUID format. Find this in your Enterprise App Store Profile settings under the Info tab, or extract it from the profile URL. |
| `Authorization` | string | No | Optional Authorization header value to use for the request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |