# Partner Central API setup
<a name="guided-setup-apis"></a>

The steps in the following sections explain how to set up the AWS Partner Central API. You must use the API in order to use the latest version of the AWS Partner CRM connector.

**Topics**
+ [Setting up named credentials](#api-named-credentials)
+ [System configuration settings](#api-sys-config-settings)
+ [Testing the connection](#testing-the-connection)

## Setting up named credentials
<a name="api-named-credentials"></a>

The AWS Partner CRM connector uses the partner's Salesforce organization credentials to authenticate with Partner Central. 

**To set up credentials**

1.  Sign in to Salesforce as a system administrator. 

1.  Under **Named credentials**, choose **New earlier**. 

1.  In the **New named credential** form, enter the values from the following table.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/partner-central/latest/crm/guided-setup-apis.html)

1.  Choose **Save**. 

1.  Return to the **AWSGuided setup** page. In the **Authentication details** section, choose **Review** and confirm the credentials. 

## System configuration settings
<a name="api-sys-config-settings"></a>

You use custom settings in the AWS Partner CRM connector to manage global settings. The following table lists and describes the settings.


| Custom setting field | Purpose | 
| --- | --- | 
| **Name** | Field isn’t used, but because it’s required, you can set it to any value. | 
| **Default account** | An 18-digit record ID of the default account that’s used when standard opportunities are used as the target object in Salesforce. Because **AccountID** is required on standard opportunities, the default account field allows new inbound opportunities from AWS to have a default account tied to them. This can be any account record in your Salesforce organization that the integration user has access to from the sharing settings. | 
| **Create New Account from Default Account** | This setting enables the connector to create a new account based on the default account provided by the partner. When checked, it allows for dynamic account creation during the integration process, ensuring that new opportunities or engagements can be associated with appropriate account records even when the exact account doesn't exist in the target system. | 
| **Default opportunity** | This option stores the 18-digit record ID of a default opportunity for use as a template. For partners using Standard Opportunity and custom objects other than an ACE Opportunity, the default record allows the connector to clone and create new opportunities or AWS referral engagements while bypassing potential required field issues. The connector clones this default record, appends new field values from the incoming data, and creates a new opportunity record. This method integrates data data with custom opportunity objects or unique field requirements. | 
| **PC API Sandbox Enabled** | Select this option to enable partners to test the connector with the AWS Partner Central API. When selected, users can create test opportunities which are sent to the AWS Sandbox API. | 

## Testing the connection
<a name="testing-the-connection"></a>

 After you complete the first two setup steps, choose **Test Configuration for APN AP**I to verify connectivity. If the connection succeeds, you receive a confirmation message.