Favicon

You are here: Home > API Reference > App Distribution > Integration Pubapps > Add new publishedApplication

Add new publishedApplication

Add new publishedApplication

POST
/v1/integrations/distributions/
Copy to clipboard

Add new publishedApplication

Add new publishedApplication

Request

Add parameter in header authorization
Example: Authorization: Bearer <token>
Body Params application/json
slug string required
URL-friendly unique identifier enabling direct public access through shareable distribution links and human-readable routing throughout platform.
≤ 128 characters · ≥ 3 characters · Match pattern: ^[a-zA-Z0-9][a-zA-Z0-9-]+[a-zA-Z0-9]$
security string required
password
tags array optional
Categorization labels enabling publication filtering, searching, and organization within store catalog for administrative management and discovery.
groups array [array] optional
Nested group name arrays implementing audience-based access control where inner arrays represent OR conditions and outer array represents AND conditions for complex permission rules.
activateUserAudiences boolean optional
Boolean flag enabling user audience-based targeting controlling whether userAudienceMap configuration actively restricts or targets distribution to specific user segments.
userAudienceMap array [object] optional
User audience assignment array linking publication to specific audience segments with notification preferences and access rules for targeted distribution management.
id string required
Match pattern: ^[a-fA-F0-9]{24}$
notifyNewBuildsProcessed boolean required
notAllowed boolean optional
userAudience object optional
id string required
Match pattern: ^[a-fA-F0-9]{24}$
name string required
description string optional
organizationId string required
Match pattern: ^[a-fA-F0-9]{24}$
applicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
application object optional
id string required
Match pattern: ^[a-fA-F0-9]{24}$
name string required
slug string required
picture string required
filter object required
groups array [array] required
emails array [string] required
usersScope string required
org app
allowedApplicationIds array [string] required
allowedApplications array [object] required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
name string required
slug string required
picture string optional
counts object required
pubApps number optional
members number optional
unmatchedEmails number optional
updatedAt string optional
createdAt string optional
password string required
≤ 128 characters · ≥ 8 characters
visibility string required
Publication discoverability status determining whether distribution appears in public store listings or requires direct URL access for hidden channels.
active inactive unlisted
showHistory boolean optional
Boolean flag controlling whether historical build versions displayed to users on distribution page enabling version browsing and rollback access.
filter object required
Build selection configuration defining automated deployment strategy and version targeting for distribution channel using tags, git references, or explicit build assignments.
type string required
Filter strategy identifier determining build selection mechanism including specific builds, tag-based filtering, git tag matching, git branch tracking, or automatic latest version distribution.
last builds gitBranch gitTag tag
value any optional
Filter criterion value used with selection strategy such as tag name, git reference, or build identifier depending on configured filter type for version targeting.
ios any optional
Build identifier for explicit platform-specific build assignment or empty string when using automatic selection strategies.
android any optional
Build identifier for explicit platform-specific build assignment or empty string when using automatic selection strategies.
macos any optional
Build identifier for explicit platform-specific build assignment or empty string when using automatic selection strategies.
windows any optional
Build identifier for explicit platform-specific build assignment or empty string when using automatic selection strategies.
builds array [object] optional
Platform-specific build entries array containing build references and metadata for each platform in multi-platform distribution enabling cross-platform version management.
buildPlatform string required
≤ 128 characters
id string required
Match pattern: ^[a-fA-F0-9]{24}$
configuration object optional
Presentation customization settings enabling white-label distribution with custom application information and visual branding for end-user facing interfaces.
application object optional
name string optional
≤ 128 characters
description string optional
≤ 1000 characters
branding object optional
logo any optional
primaryColor any optional
buttonColor any optional
useAppIcon boolean optional
terms object optional
Terms and conditions configuration requiring user acceptance before download including activation status and full legal text for compliance requirements.
active boolean optional
text any optional
showDevInfo boolean optional
Boolean flag determining whether developer information and technical build metadata displayed to end users for transparency and troubleshooting.
allowedCountries array [string] optional
ISO country code array implementing geographic whitelist restricting access to specific countries for compliance with regional licensing and distribution rights.
blockedCountries array [string] optional
ISO country code array implementing geographic blacklist preventing access from specific countries for export control and regulatory compliance.
hideAttachedFiles boolean optional
Boolean flag controlling visibility of supplementary files and resources on distribution page determining what additional materials users can access.
expirationDate any optional
ISO 8601 timestamp defining when publication becomes unavailable for download enabling time-limited distributions, beta programs, and promotional campaigns.
{
    "slug": "string",
    "security": "password",
    "tags": [
        "string"
    ],
    "groups": [
        [
            "string"
        ]
    ],
    "activateUserAudiences": true,
    "userAudienceMap": [
        {
            "id": "string",
            "notifyNewBuildsProcessed": true,
            "notAllowed": true,
            "userAudience": {
                "id": "string",
                "name": "string",
                "description": "string",
                "organizationId": "string",
                "applicationId": "string",
                "application": {
                    "id": "string",
                    "name": "string",
                    "slug": "string",
                    "picture": "string"
                },
                "filter": {
                    "groups": [
                        [
                            "string"
                        ]
                    ],
                    "emails": [
                        "[email protected]"
                    ]
                },
                "usersScope": "org",
                "allowedApplicationIds": [
                    "string"
                ],
                "allowedApplications": [
                    {
                        "id": "string",
                        "name": "string",
                        "slug": "string",
                        "picture": "string"
                    }
                ],
                "counts": {
                    "pubApps": 0,
                    "members": 0,
                    "unmatchedEmails": 0
                },
                "updatedAt": "string",
                "createdAt": "string"
            }
        }
    ],
    "password": "string",
    "visibility": "active",
    "showHistory": true,
    "filter": {
        "type": "last",
        "value": "string",
        "ios": "string",
        "android": "string",
        "macos": "string",
        "windows": "string",
        "builds": [
            {
                "buildPlatform": "string",
                "id": "string"
            }
        ]
    },
    "configuration": {
        "application": {
            "name": "string",
            "description": "string"
        },
        "branding": {
            "logo": "string",
            "primaryColor": "string",
            "buttonColor": "string",
            "useAppIcon": true
        }
    },
    "terms": {
        "active": true,
        "text": "string"
    },
    "showDevInfo": true,
    "allowedCountries": [
        "AF"
    ],
    "blockedCountries": [
        "AF"
    ],
    "hideAttachedFiles": true,
    "expirationDate": "string"
}

Responses

200 Response application/json
status boolean required
data object required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
updatedAt string required
createdAt string required
application string required
Match pattern: ^[a-fA-F0-9]{24}$
applicationInfo object required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
slug string required
name string required
picture string required
slug string required
≤ 128 characters · ≥ 3 characters · Match pattern: ^[a-zA-Z0-9][a-zA-Z0-9-]+[a-zA-Z0-9]$
filter object required
type string required
last builds gitBranch gitTag tag
value string required
ios string optional
Match pattern: ^[a-fA-F0-9]{24}$
android string optional
Match pattern: ^[a-fA-F0-9]{24}$
windows string optional
Match pattern: ^[a-fA-F0-9]{24}$
macos string optional
Match pattern: ^[a-fA-F0-9]{24}$
builds array [object] required
buildPlatform string required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
security string required
public password logged
tags array [string] required
groups array [array] required
visibility string required
active inactive unlisted
showHistory boolean required
showDevInfo boolean required
distributionUrl string required
activateUserAudiences boolean required
userAudienceMap array [object] required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
notifyNewBuildsProcessed boolean required
notAllowed boolean optional
userAudience object optional
id string required
Match pattern: ^[a-fA-F0-9]{24}$
name string required
description string optional
organizationId string required
Match pattern: ^[a-fA-F0-9]{24}$
applicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
application object optional
id string required
Match pattern: ^[a-fA-F0-9]{24}$
name string required
slug string required
picture string required
filter object required
groups array [array] required
emails array [string] required
usersScope string required
org app
allowedApplicationIds array [string] required
allowedApplications array [object] required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
name string required
slug string required
picture string optional
counts object required
pubApps number optional
members number optional
unmatchedEmails number optional
updatedAt string optional
createdAt string optional
terms object required
active boolean required
text string required
configuration object optional
application object optional
name string optional
≤ 128 characters
description string optional
≤ 1000 characters
branding object optional
logo any optional
primaryColor any optional
buttonColor any optional
useAppIcon boolean optional
allowedCountries array [string] optional
blockedCountries array [string] optional
hideAttachedFiles boolean optional
expirationDate string required 
{
    "status": true,
    "data": {
        "id": "string",
        "updatedAt": "string",
        "createdAt": "string",
        "application": "string",
        "applicationInfo": {
            "id": "string",
            "slug": "string",
            "name": "string",
            "picture": "string"
        },
        "slug": "string",
        "filter": {
            "type": "last",
            "value": "string",
            "ios": "string",
            "android": "string",
            "windows": "string",
            "macos": "string",
            "builds": [
                {
                    "buildPlatform": "string",
                    "id": "string"
                }
            ]
        },
        "security": "public",
        "tags": [
            "string"
        ],
        "groups": [
            [
                "string"
            ]
        ],
        "visibility": "active",
        "showHistory": true,
        "showDevInfo": true,
        "distributionUrl": "string",
        "activateUserAudiences": true,
        "userAudienceMap": [
            {
                "id": "string",
                "notifyNewBuildsProcessed": true,
                "notAllowed": true,
                "userAudience": {
                    "id": "string",
                    "name": "string",
                    "description": "string",
                    "organizationId": "string",
                    "applicationId": "string",
                    "application": {
                        "id": "string",
                        "name": "string",
                        "slug": "string",
                        "picture": "string"
                    },
                    "filter": {
                        "groups": [
                            [
                                "string"
                            ]
                        ],
                        "emails": [
                            "[email protected]"
                        ]
                    },
                    "usersScope": "org",
                    "allowedApplicationIds": [
                        "string"
                    ],
                    "allowedApplications": [
                        {
                            "id": "string",
                            "name": "string",
                            "slug": "string",
                            "picture": "string"
                        }
                    ],
                    "counts": {
                        "pubApps": 0,
                        "members": 0,
                        "unmatchedEmails": 0
                    },
                    "updatedAt": "string",
                    "createdAt": "string"
                }
            }
        ],
        "terms": {
            "active": true,
            "text": "string"
        },
        "configuration": {
            "application": {
                "name": "string",
                "description": "string"
            },
            "branding": {
                "logo": "string",
                "primaryColor": "string",
                "buttonColor": "string",
                "useAppIcon": true
            }
        },
        "allowedCountries": [
            "AF"
        ],
        "blockedCountries": [
            "AF"
        ],
        "hideAttachedFiles": true,
        "expirationDate": "string"
    }
}
400 Response application/json
status boolean optional
false
error object optional
code number optional
5024
message string optional
Slug already used
{
    "status": false,
    "error": {
        "code": 5024,
        "message": "Slug already used"
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}