Pica CLI

Build performant, high-converting native integrations with a few lines of code. By unlocking more integrations, you can onboard more customers and expand app usage, overnight.

Visit us at picaos.com

Table of Contents

• Installation
• Docker Setup
  • Start
  • Stop
• Initialization
• Supported Operations
• Commands Reference
  • Common Enums
    • List | Add | Pull | Push | Delete
  • Common Models
    • List | Add | Pull | Push | Delete
  • Platforms
    • List | Add | Pull | Push | Delete
    • Additional Platform Operations
      • Add Model
      • Add OAuth
      • Push Model
      • Push Action

Installation

npm install -g @picahq/cli

Docker Setup

Commands

Start

To start the docker containers. All the inputs are required. Seeding is optional, but recommended when running the command for the first time.

pica start

Example

# To start the docker containers
pica start 
Enter the IOS Crypto Secret (32 characters long): xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Do you want to seed? (Y/N) y

Stop

To stop the docker containers.

pica stop

Initialization

To generate the configuration file. All the inputs are optional. Press enter without entering anything to use the system-default value.

pica init

Example

# To generate the configuration file
pica init
Enter the Mongo Password: (system default) mongo-password
Enter the Buildable Secret: (system default) buildable-secret
Enter the Default Live Access Key: (system default) default-live-access-key
Enter the Default Test Access Key: (system default) default-test-access-key
Enter the Developer Account Access Key: (system default) developer-account-access-key
Enter the Event Access Password: (system default) event-access-password
Enter the JWT Secret: (system default) jwt-secret
Enter the Gateway Secret: (system default) gateway-secret
Enter the API URL: (system default) api-url
Enter the X IOS Secret: (system default) x-ios-secret
Enter the Bearer Token: (system default) bearer-token

Supported Operations

Entity	Operations								Extra Operations
	List	Add	Push		Pull		Delete
			All	Specific	All	Specific	All	Specific
Common Enums	✓	X	✓	✓	✓	✓	X	X	X
Common Models	✓	✓	✓	✓	✓	✓	X	✓	X
Platforms	✓	✓	✓	✓	✓	✓	X	✓	Add Model	Add Oauth

Commands

The following commands are available to work with Common Models, Common Enums or Platforms.

Common Enums

Perform operations on common enums.

List

List common enum(s) available in the database.

pica list enum

Add

Add common enum(s) to the repository. A warning will be shown if an enum is already available in the Database.

pica add enum

Example

# To add specific enum(s)
pica add enum
Enter the names of enums: UserStatus WebhookState

Pull

Pull common enum(s) from the database to the repository. One also has the option to validate after the pull is done. Doing so, will cross-check the data pulled with the data available in the database and notify the user about any discrepancy.

pica pull enum

Examples

# To pull all enums 
pica pull enum
Do you want to pull all common enums? (Y/N) y
Do you want to validate each common enum after pulling? (Y/N) y

# To pull specific enum(s)
pica pull enum
Do you want to pull all common enums? (Y/N) n
Enter the names of enums: AddressType SocialProfileType
Do you want to validate each common enum after pulling? (Y/N) y

Push

Push common enum(s) from the repository to the database.

pica push enum

Examples

# To push all enums 
pica push enum
Do you want to push all common enums? (Y/N) y

# To push specific enum(s)
pica push enum
Do you want to push all common enums? (Y/N) n
Enter the names of enums: EventRuleType TimeCycle

Delete

Delete common enum(s) from the repository and the database.

pica delete enum

Example

# To delete specific enum(s)
pica delete enum
Enter the names of enums: UserStatus TaxType

Common Models

Perform operations on common models.

List

List common model(s) available in the database.

pica list model

Add

Add common model(s) to the repository. A warning will be shown if a model is already available in the Database.

pica add model

Example

# To add specific model(s)
pica add model
Enter the names of models: Contacts Deals

Pull

Pull common model(s) from the database to the repository. One also has the option to validate after the pull is done. Doing so, will cross-check the data pulled with the data available in the database and notify the user about any discrepancy.

pica pull model

Examples

# To pull all models 
pica pull model
Do you want to pull all common models? (Y/N) y
Do you want to validate each common model after pulling? (Y/N) y

# To pull specific model(s)
pica pull model
Do you want to pull all common models? (Y/N) n
Enter the names of models: Customers Webhooks
Do you want to validate each common model after pulling? (Y/N) y

Push

Push common model(s) from the repository to the database.

pica push model

Examples

# To push all models 
pica push model
Do you want to push all common models? (Y/N) y

# To push specific model(s)
pica push model
Do you want to push all common models? (Y/N) n
Enter the names of models: Customers Webhooks

Delete

Delete common model(s) from the repository and the database.

pica delete model

Example

# To delete specific model(s)
pica delete model
Enter the names of models: Leads Opportunities

Platforms

Perform operations on platforms.

List

List platform(s) available in the database.

pica list platform

Add

Add platform to the repository. A warning will be shown if a platform is already available in the Database. The default authentication method is oauth.

pica add platform

Example

# To add a platform
pica add platform
Enter the name of the platform: ZenMail
Enter the authentication method (oauth/bearer/basic/apiKey/oauthLegacy/none): (oauth) apiKey
Enter the names of models: Addresses Discounts

Add Model

Add model(s) to the platform.

pica add platformModel

Example

# To add model(s) to a platform
pica addPlatformModel
Enter the name of the platform: BananaShake
Enter the names of models: Accounts Users

Add OAuth

Add oauth configuration for a platform.

pica add platformOAuth

Example

# To add oauth for a platform
pica add platformOAuth
Enter the name of the platform: Boogle

Pull

Pull platform(s) from the database to the repository. One also has the option to validate after the pull is done. Doing so, will cross-check the data pulled with the data available in the database and notify the user about any discrepancy.

pica pull platform

Examples

# To pull all platforms
pica pull platform
Do you want to pull all platforms? (Y/N) y
Do you want to validate each platform after pulling? (Y/N) y

# To pull specific platform(s)
pica pull platform 
Do you want to pull all platforms? (Y/N)
Enter the names of platforms: FaceGram InstaBook
Do you want to validate each platform after pulling? (Y/N) y

Push

Push platform(s) from the repository to the database.

pica push platform

Examples

# To push all platforms 
pica push platform
Do you want to push all platforms? (Y/N) y
Do you want to set the actions as active? (Y/N) y

# To push specific platform(s)
pica push platform 
Do you want to push all platforms? (Y/N) n
Enter the names of platforms: ShopCommerce Bigify
Do you want to set the actions as active? (Y/N) y

Push Model

Push platform model(s) from the repository to the database. Pushing the model actions will push all actions.

pica push platformModel

Examples

# To push all platform models 
pica push platformModel
Enter the name of the platform: Clove
Do you want to push all the platform models? (Y/N) y
Do you also want to push all the actions in the selected models? (Y/N) y
Do you want to set the actions as active? (Y/N) y

# To push specific platform model(s)
pica push platform Model
Enter the name of the platform: Bean
Do you want to push all the platform models? (Y/N) y
Enter the names of models: Accounts
Do you also want to push all the actions in the selected models? (Y/N) y
Do you want to set the actions as active? (Y/N) y

Push Actions

Push platform actions from the repository to the database. All actions will be pushed.

pica push platformAction

Examples

# To push all platform model actions 
pica push platformAction
Enter the name of the platform: MeetLink
Do you want to push actions for all the platform models? (Y/N) y
Do you want to set the actions as active? (Y/N) y

# To push specific platform model actions
pica push platformAction 
Enter the name of the platform: Chrome
Do you want to push actions for all the platform models? (Y/N) n
Enter the names of models: Accounts
Do you want to set the actions as active? (Y/N) y

Delete

Delete platform(s) from the repository and the database.

pica delete platform

Example

# To delete specific platform(s)
pica delete platform
Enter the names of platforms: Bwitter Orange