bldr logo
Get Started

$ config

Getting setup with BLDR is straightforward and can be done in just a few minutes. New configurations require that an Installed Package be created within Salesforce Marketing Cloud following the permissions provided in the Getting Started documentation.

flagsdescription
-n, --newCreate New Configuration
[instance name]View Instance Configuration
-l, --listList all Configurations
-s --setSet Target Configuration to Use
>> -m, --midSet Target MID to Use
-r, --removeRemove Configuration
--verboseToggle Verbose Messaging

New Configuration

bldr config -n | bldr config --new

  $ bldr config -n
  ? SFMC Instance Name: BrandyMKTG
  ? Parent MID: 2928190
  ? API Client ID: ydnard9282zeuwo
  ? API Client Secret: ast3183alskdj282d
  ? Authentication URI: https://mcsfmc9380sk-0292.auth.marketingcloudapis.com/

Show Instance Details

bldr config <SFMC instance Name>

$ bldr config BrandyMKTG
Instance Details (showing first 5 characters of credentials)                    
----
{                                                                               
  "instance": "BrandyMKTG",                                                        
  "parentMID": "2928190",                                                     
  "apiClientId": "ydnar",                                                       
  "apiClientSecret": "ast31",                                                   
  "authURI": "https://mcsfmc9380sk-0292.auth.marketingcloudapis.com/",                                 
  "mids": [                                                                     
    {                                                                           
      "mid": 2928190,                                                         
      "name": "BrandyMKTG"                                                         
    }                                                                           
  ]                                                                             
}                                                  

Show Configured Instances

bldr config -l | bldr config --list

$ bldr config -l
Configured Instances                
----
BrandyMKTG                      
CodyDev                       
AstroB2C                      

Set Target Configuration

bldr config -s CodyDev | bldr config --set CodyDev

$ bldr config -s CodyDev
Configuration Set                                                               
----
{                                                                               
  "instance": "CodyDev",                                                       
  "parentMID": "992823772",                                                
  "activeMID": "992823772"                                                      
}      

Set Target MID

bldr config -s CodyDev -m 992822209 | bldr config --set CodyDev --mid 992822209

$ bldr config -s CodyDev -m 992822209
CodyDev has been set to target instance                                                               
----
{                                                                               
  "instance": "CodyDev",                                                       
  "parentMID": "992823772",                                                     
  "activeMID": "992822209"                                                      
}      

Remove Configuration

bldr config -r CodyDev | bldr config --remove CodyDev

$ bldr config -r CodyDev
Instance Details                                                                
----
{                                                                               
  "instance": "CodyDev",                                                       
  "parentMID": "992823772",                                                     
  "apiClientId": "codev",                                                       
  "apiClientSecret": "cd792",                                                   
  "authURI": "https://mcdev938-s9djskj.auth.marketingcloudapis.com/",                                 
  "mids": [                                                                     
    {                                                                           
      "mid": 992823772,                                                         
      "name": "CodyDev"                                                         
    },
    {                                                                           
      "mid": 992822209,                                                         
      "name": "Dev_Sandbox"                                                         
    }                                                                           
  ]                                                                             
}                                                                               
? Please confirm deletion of CodyDev (Y/n): y

CodyDev was Deleted Successfully.
Getting StartedStatus