Skip to main content
Conga Support

Anatomy of a Conga Composer Button

There are two types of Composer buttons: non-OAuth and OAuth (Open Authorization).

Non-OAuth Buttons

All non-OAuth Conga Composer® URLs start the same way. The first three lines are identical in every Composer URL, and the fourth line is customized to identify the Master Object from which you’ll be gathering data and running the solution. These first lines are referred to as the Base URL, which look like this:

https://composer.congamerge.com
?SessionId={!API.Session_ID}
&ServerUrl={!API.Partner_Server_URL_210}
&Id=

 

OAuth Buttons

OAuth (Open Authorization) is a different security protocol that is required for all Conga Composer buttons created in the Salesforce Lightning user interface.  The Base URL of an OAuth button looks like this:

/apex/APXTConga4__Conga_Composer
?id=

​In both button types, the &Id= parameter (or ?id= in the OAuth button) defines your master object – the Salesforce® object from which you will launch your Composer solution. The value of this parameter should always be the record ID of your master object. For example:

To launch the solution from this type of object: The fourth line would contain:
Account &id={!Account.Id}
Opportunity &id={!Opportunity.Id}
Case &id={!Case.Id}
A custom object &id={!CustomObjectName_c.Id}

Conga Composer includes sample buttons on the following standard objects so you can easily copy and paste the Base URL from the sample button into your custom button (which is necessary if you are creating buttons without the Conga Solution Manager):

  • Lead
  • Contact
  • Account
  • Opportunity
  • Case
  • Contract

Composer Parameters

After the Base URL, you will see the Composer parameters that have been added to the Composer solution (assuming they have been added by the Conga Admin).  Parameters are settings that control the behavior of your solution.  They always use the following convention: &ParameterName=Value.

In the example below, you can see seven parameters have been added to this Composer button URL:

https://composer.congamerge.com?SolMgr=1
&sessionId={!API.Session_ID}
&serverUrl={!API.Partner_Server_URL_290}
&Id={!Opportunity.Id}

&TemplateId=a0436000001AbCp

&CongaEmailTemplateId=a0236000001gl7C

&TemplateGroup=Invoice
&DefaultPDF=1
&OFN=Conga+Invoice+-+{!Opportunity.Name}+-+{!Today}
&SC0=1
&SC1=Attachments​​​​

The parameters in this example control template selection, output file type, output file name, and where to save a copy of the output document.  For more information about parameters, see Customizing Composer with Parameters.

See Composer button URL examples for more examples.

  • Was this article helpful?