# Google Partners API . companies . leads

## Instance Methods

Creates an advertiser lead for the given company ID.

### Method Details

`create(companyId, body, x__xgafv=None)`

    Creates an advertiser lead for the given company ID.

    Args:
      companyId: string, The ID of the company to contact. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # Request message for [CreateLead][google.partners.v2.Partner.CreateLead].
        "requestMetadata": { # Common data that is in each API request. # Current request metadata.
          "locale": "A String", # Locale to use for the current request.
          "partnersSessionId": "A String", # Google Partners session ID.
          "trafficSource": { # Source of traffic for the current request. # Source of traffic for the current request.
            "trafficSubId": "A String", # Second level identifier to indicate where the traffic comes from. An identifier has multiple letters created by a team which redirected the traffic to us.
            "trafficSourceId": "A String", # Identifier to indicate where the traffic comes from. An identifier has multiple letters created by a team which redirected the traffic to us.
          },
          "userOverrides": { # Values to use instead of the user's respective defaults. These are only honored by whitelisted products. # Values to use instead of the user's respective defaults for the current request. These are only honored by whitelisted products.
            "userId": "A String", # Logged-in user ID to impersonate instead of the user's ID.
            "ipAddress": "A String", # IP address to use instead of the user's geo-located IP address.
          },
          "experimentIds": [ # Experiment IDs the current request belongs to.
            "A String",
          ],
        },
        "recaptchaChallenge": { # reCaptcha challenge info. # reCaptcha challenge info.
          "id": "A String", # The ID of the reCaptcha challenge.
          "response": "A String", # The response to the reCaptcha challenge.
        },
        "lead": { # A lead resource that represents an advertiser contact for a `Company`. These are usually generated via Google Partner Search (the advertiser portal). # The lead resource. The `LeadType` must not be `LEAD_TYPE_UNSPECIFIED` and either `email` or `phone_number` must be provided.
          "gpsMotivations": [ # List of reasons for using Google Partner Search and creating a lead.
            "A String",
          ],
          "familyName": "A String", # Last name of lead source.
          "minMonthlyBudget": { # Represents an amount of money with its currency type. # The minimum monthly budget lead source is willing to spend.
            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
            "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
          },
          "comments": "A String", # Comments lead source gave.
          "email": "A String", # Email address of lead source.
          "websiteUrl": "A String", # Website URL of lead source.
          "phoneNumber": "A String", # Phone number of lead source.
          "givenName": "A String", # First name of lead source.
          "type": "A String", # Type of lead.
          "id": "A String", # ID of the lead.
        },
      }

      x__xgafv: string, V1 error format.

    Returns:
      An object of the form:

        { # Response message for [CreateLead][google.partners.v2.Partner.CreateLead]. Debug information about this request.
        "recaptchaStatus": "A String", # The outcome of reCaptcha validation.
        "lead": { # A lead resource that represents an advertiser contact for a `Company`. These are usually generated via Google Partner Search (the advertiser portal). # Lead that was created depending on the outcome of reCaptcha validation.
          "gpsMotivations": [ # List of reasons for using Google Partner Search and creating a lead.
            "A String",
          ],
          "familyName": "A String", # Last name of lead source.
          "minMonthlyBudget": { # Represents an amount of money with its currency type. # The minimum monthly budget lead source is willing to spend.
            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
            "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
          },
          "comments": "A String", # Comments lead source gave.
          "email": "A String", # Email address of lead source.
          "websiteUrl": "A String", # Website URL of lead source.
          "phoneNumber": "A String", # Phone number of lead source.
          "givenName": "A String", # First name of lead source.
          "type": "A String", # Type of lead.
          "id": "A String", # ID of the lead.
        },
        "responseMetadata": { # Common data that is in each API response. # Current response metadata.
          "debugInfo": { # Debug information about this request. # Debug information about this request.
            "serverTraceInfo": "A String", # Server-side debug stack trace.
            "serviceUrl": "A String", # URL of the service that handled this request.
            "serverInfo": "A String", # Info about the server that serviced this request.
          },
        },
      }